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

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 die Azure API for FHIR® bereitgestellt und Ihre Client-Anwendung registriert. Jetzt können Sie Azure API for FHIR testen.

Rufen Sie die Funktionsanweisung ab

Zuerst erhalten wir die Funktionsanweisung für Azure API for FHIR ab.

1. Öffne Postman.
2. 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.

Als Nächstes versuchen wir, Patientendaten abzurufen. Um Patientendaten abzurufen, verwenden Sie GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. Sie werden einen 401 Unauthorized Fehler erhalten, weil Sie noch nicht nachgewiesen haben, dass Sie Zugriff auf Patientendaten haben müssen.

Abrufen von Patientendaten vom FHIR-Server

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

1. Wählen Sie in Postman die Option Autorisierung aus, und legen Sie den Typ auf OAuth 2.0 fest.
2. Wählen Sie Neuen Zugriffstoken erhalten aus.
3. 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

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

Veröffentlichen von Patientendaten auf dem FHIR-Server

Nun haben Sie Zugriff, Sie 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"
    }

Dieser POST erstellt einen neuen Patienten auf dem FHIR-Server mit dem Namen James Tiberious Kirk.

Wenn Sie den GET-Befehl zum Abrufen von Patientendaten erneut verwenden, 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

Empfangen eines 403-Fehlers beim Versuch, von Postman auf die Ressource Patient zuzugreifen.

Überprüfen Sie, ob die Teilnehmerrolle FHIR zugewiesen ist; falls nicht, fügen Sie die Teilnehmerrolle FHIR zu Azure Health Data Services hinzu. Konfigurieren von Azure RBAC-Rollen für AHDS

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

Hinweis

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