API RESTful

Endpoint FHIR

API Enti erogatori

I servizi FHIR esposti dai Sistemi Informativi degli Enti Erogatori sono accessibili attraverso i canali protetti tra ARIAspa e gli Enti stessi. Il base_url con cui accedere a tali servizi è il seguente:

    <base_API_Ente> = http://<ip_pubblico_ente>/<contesto>/<codice_Cudes_L1>/v1.0.0/occupazione-pl

dove:

  • < ip_pubblico_ente >: corrisponde all'indirizzo dell'IP pubblico dell'Ente assegnato da ARIA
  • < contesto >: può assumere i seguenti valori a seconda del protocollo scelto per l’integrazione e dell’ambiente utilizzato:
    • fhir per integrazioni via standard FHIR in produzione reale;
    • fhirtest per integrazioni via standard FHIR in Produzione virtuale, da utilizzare per i test propedeutici all'avvio in produzione;
  • < codice_Cudes_L1 >: codice L1 dell'Ente Erogatore

Si precisa che il numero della porta utilizza è la 80, prevista di default per HTTP, e che, in caso si utilizzi il contesto FHIR, l’endpoint indicato è da considerarsi un base URL al quale seguirà il nome della risorsa FHIR interrogata.

L'elenco delle API esposte è:

Metodo HTTP URL Detentore del dato
GET <base_API_Ente>/Location Ente Erogatore

Le chiamate HTTP relative all'integrazione FHIR devono contenere i seguenti header:

Nome header Valore Descrizione
Content-Type application/fhir+json mime type del formato di scambio