Testen der FHIR-API für Azure API for FHIR

Artikel
10/16/2024

Wichtig

Azure API for FHIR wird am 30. September 2026 eingestellt. Folgen Sie den Migrationsstrategien, um bis zu diesem Datum zum Azure Health Data Services FHIR®-Dienst zu wechseln. Aufgrund der Einstellung von Azure API for FHIR werden neue Bereitstellungen ab dem 1. April 2025 nicht zugelassen. Der Azure Health Data Services-FHIR-Dienst ist die weiterentwickelte Version der Azure-API für FHIR, mit der Kundschaft FHIR-, DICOM- und Medizintechnikdienste mit Integrationen in andere Azure-Dienste verwalten kann.

Im vorherigen Tutorial haben Sie Azure API for FHIR bereitgestellt und die Clientanwendung registriert. Jetzt können Sie Azure API for FHIR testen.

Abrufen der Funktionsbestätigung

Zuerst rufen Sie die Funktionsbestätigung für Azure API for FHIR ab.

Öffne Postman.
Rufen Sie die Funktionsanweisung mithilfe von GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata ab. In der folgenden Abbildung lautet der Name des FHIR-Servers fhirserver.

Funktionsbestätigung

Als Nächstes versuchen Sie, Patientendaten abzurufen. Um Patientendaten abzurufen, geben Sie GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient ein. Es wird ein Fehler vom Typ „401 – Nicht autorisiert“ angezeigt. Dieser Fehler tritt auf, weil Sie noch nicht nachgewiesen haben, dass Sie Zugriff auf Patientendaten haben müssen.

Abrufen von Patientendaten vom FHIR-Server

Fehler beim Abrufen von Patientendaten

Um Zugriff zu erhalten, benötigen Sie ein Zugriffstoken.

Wählen Sie in Postman die Option Autorisierung aus, und legen Sie den Typ auf OAuth 2.0 fest.
Wählen Sie Neuen Zugriffstoken erhalten aus.
Füllen Sie die Felder aus, und wählen Sie Token anfordern aus. Nachfolgend sind die Werte der einzelnen Felder für dieses Tutorial angegeben.

Feld	Wert
Tokenname	Ein Name für das Token
Grant Type	Autorisierungscode
Callback URL	https://www.getpostman.com/oauth2/callback
Auth URL	https://login.microsoftonline.com/<AZURE-AD-MANDANTEN-ID>/oauth2/?resource=https://<FHIR-SERVER-NAME>.azurehealthcareapis.com
Zugriffs-Token URL	https://login.microsoftonline.com/<AZURE-AD-MANDANTEN-ID>/oauth2/token
Client-ID	Die Client-ID, die Sie in den vorherigen Schritten kopiert haben
Geheimer Clientschlüssel	<LEER>
`Scope`	<LEER>
Staat	1234
Clientauthentifizierung	Clientanmeldeinformationen im Text senden

Melden Sie sich mit Ihren Anmeldeinformationen an, und wählen Sie Akzeptieren aus.
Scrollen Sie im Ergebnis nach unten, und wählen Sie Token verwenden aus.
Wählen Sie oben erneut Senden aus. Dieses Mal sollten Sie ein Ergebnis erhalten.

Veröffentlichen von Patientendaten auf dem FHIR-Server

Nun haben Sie Zugriff und können einen neuen Patienten erstellen. Hier sehen Sie ein Beispiel für einfache Patientendaten, die Sie auf dem FHIR-Server hinzufügen können. Geben Sie json in den Abschnitt Text von Postman ein.

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

Mit diesem POST-Vorgang wird ein neuer Patient auf dem FHIR-Server mit dem Namen James Tiberious Kirk erstellt. Veröffentlichen von Patientendaten

Wenn Sie den GET-Befehl zum Abrufen von Patientendaten erneut ausführen, wird James Tiberious Kirk in der Ausgabe aufgelistet.

Hinweis

Beim Senden von Anforderungen an Azure API for FHIR müssen Sie sicherstellen, dass Sie den Content-Type-Header auf application/json festlegen.

Behandeln von Zugriffsproblemen

Wenn bei einem dieser Schritte Probleme aufgetreten sind, sehen Sie in den Dokumenten nach, die wir zu Microsoft Entra ID und Azure API for FHIR zusammengestellt haben.

Microsoft Entra ID und Azure API for FHIR: In diesem Dokument werden einige der grundlegenden Prinzipien von Microsoft Entra ID und dessen Interaktion mit Azure API for FHIR beschrieben.
Überprüfung von Zugriffstoken: Diese Schrittanleitung enthält genauere Informationen zur Überprüfung von Zugriffstoken sowie Schritte zur Behebung von Zugriffsproblemen.

Nächste Schritte

Nachdem Sie nun erfolgreich eine Verbindung mit Ihrer Clientanwendung hergestellt haben, können Sie die Webanwendung schreiben.

Schreiben einer Webanwendung

FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.

Teilen über