Test dell'API FHIR in API di Azure per FHIR

Articolo
12/04/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 è stata distribuita l'API di Azure per FHIR® ed è stata registrata l'applicazione client. È ora possibile testare API di Azure per FHIR.

Recuperare l'istruzione capability

Prima di tutto si ottiene l'istruzione capability per l'API di Azure per FHIR.

Aprire Postman.
Recuperare l'istruzione capability usando GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata. Nell'immagine seguente il nome del server FHIR è fhirserver.

Dichiarazione di funzionalità

Successivamente si tenta di recuperare un paziente. Per recuperare un paziente, usare GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. Viene visualizzato un 401 Unauthorized errore perché non è stato dimostrato di avere accesso ai dati dei pazienti.

Accesso al paziente non riuscito

Ottenere un paziente dal server FHIR

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 Invia nella parte superiore e questa volta si otterrà un risultato:

Success Patient

Pubblicare il paziente nel server FHIR

Ora che si ha 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"
    }

Questo POST crea un nuovo paziente nel server FHIR con il nome James Tiberious Kirk.

Pubblicare il paziente

Se si usa il comando GET per recuperare di nuovo un paziente, nell'output verrà visualizzato James Tiberious Kirk.

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

Ricezione di un errore 403 durante il tentativo di accesso alla risorsa Paziente da Postman.

Controllare se viene assegnato il ruolo collaboratore FHIR; in caso contrario, aggiungere il ruolo Collaboratore FHIR a Servizi dati di integrità di Azure. Configurare i ruoli controllo degli accessi in base al ruolo di Azure per AHDS

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

Nota

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

Condividi tramite