Test dell'API FHIR in API di Azure per FHIR

Articolo
09/23/2024

Importante

L'API di Azure per FHIR verrà ritirata il 30 settembre 2026. Seguire le strategie di migrazione per passare al servizio FHIR® di Servizi per i dati sanitari di Azure entro tale data. A causa del ritiro dell'API di Azure per FHIR, le nuove distribuzioni non saranno consentite a partire dal 1° aprile 2025. Il servizio FHIR di Servizi per i dati sanitari di Azure è la versione evoluta dell'API di Azure per FHIR che consente ai clienti di gestire i servizi FHIR, DICOM e MedTech con integrazioni in altri servizi di Azure.

Nell'esercitazione precedente è stato distribuito il servizio API di Azure per FHIR ed è stata registrata l'applicazione client. È ora possibile testare API di Azure per FHIR.

Recuperare la dichiarazione di funzionalità

Prima di tutto si otterrà la dichiarazione di funzionalità per API di Azure per FHIR.

Aprire Postman.
Recuperare la dichiarazione di funzionalità eseguendo GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata. Nell'immagine seguente il nome del server FHIR è fhirserver.

Dichiarazione di funzionalità

Successivamente si proverà a recuperare un paziente. Per recuperare un paziente, immettere GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. Si riceverà un errore 401 di operazione non autorizzata. Questo errore si verifica perché non è stato dimostrato che l'acceso ai dati dei pazienti è consentito.

Ottenere un paziente dal server FHIR

Accesso al paziente non riuscito

Per ottenere l'accesso, è necessario un token di accesso.

In Postman selezionare Authorization e impostare il tipo su OAuth2.0.
Selezionare Ottieni nuovo token di accesso.
Compilare i campi e selezionare Request Token (Richiedi token). Di seguito sono riportati i valori per ogni campo per questa esercitazione.

Campo	valore
Token Name (Nome del token)	Un nome per il token
Tipo di concessione	Codice di autorizzazione
Callback URL (URL callback)	https://www.getpostman.com/oauth2/callback
Auth URL (URL autorizzazione)	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/?resource=https://<FHIR-SERVER-NAME>.azurehealthcareapis.com
URL del token di accesso	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/token
ID client	L'ID client copiato nei passaggi precedenti
Segreto client	<BLANK>
Ambito	<BLANK>
Provincia	1234
Autenticazione client	Invia le credenziali del client nel corpo

Accedere con le proprie credenziali e selezionare Accept (Accetta)
Scorrere verso il basso nel risultato e selezionare Use Token (Usa token)
Selezionare di nuovo Send in alto e questa volta si dovrebbe ottenere il risultato

Pubblicare il paziente nel server FHIR

Una volta ottenuto l'accesso, è possibile creare un nuovo paziente. Ecco un esempio di un semplice paziente che è possibile aggiungere al server FHIR. Immettere il codice json nella sezione Body di Postman.

    {
        "resourceType": "Patient",
        "active": true,
        "name": [
            {
                "use": "official",
                "family": "Kirk",
                "given": [
                    "James",
                    "Tiberious"
                ]
            },
            {
                "use": "usual",
                "given": [
                    "Jim"
                ]
            }
        ],
        "gender": "male",
        "birthDate": "1960-12-25"
    }

Questa istruzione POST creerà un nuovo paziente nel server FHIR con il nome James Tiberious Kirk. Pubblicare il paziente

Se si esegue di nuovo il comando GET per recuperare un paziente, si noterà che James Tiberious Kirk è presente nell'output.

Nota

Quando si inviano richieste ad API di Azure per FHIR, è necessario assicurarsi di aver impostato l'intestazione content-type su application/json

Risoluzione dei problemi di accesso

Se si verificano problemi durante uno di questi passaggi, esaminare i documenti relativi ad Microsoft Entra ID e ad API di Azure per FHIR.

Microsoft Entra ID e API di Azure per FHIR: questo documento illustra alcuni principi di base di Microsoft Entra ID e la relativa interazione con API di Azure per FHIR.
Convalida dei token di accesso: questa guida pratica fornisce dettagli più specifici sulla convalida dei token di accesso e sui passaggi da eseguire per risolvere i problemi di accesso.

Passaggi successivi

Ora che è possibile connettersi all'applicazione client, si è pronti per scrivere l'applicazione Web.

Scrivere un'applicazione Web

FHIR® è un marchio registrato di HL7 ed è usato con l'autorizzazione di HL7.

Condividi tramite