De FHIR-API testen in Azure API for FHIR

Artikel
12/04/2024

Belangrijk

Azure API for FHIR wordt op 30 september 2026 buiten gebruik gesteld. Volg de migratiestrategieën om op die datum over te stappen naar de FHIR-service® van Azure Health Data Services. Vanwege de buitengebruikstelling van Azure API for FHIR zijn nieuwe implementaties vanaf 1 april 2025 niet toegestaan. De FHIR-service van Azure Health Data Services is de ontwikkelde versie van Azure API for FHIR waarmee klanten FHIR-, DICOM- en MedTech-services kunnen beheren met integraties in andere Azure-services.

In de vorige zelfstudie hebt u de Azure API for FHIR® geïmplementeerd en uw clienttoepassing geregistreerd. U bent nu klaar om uw Azure API for FHIR te testen.

De mogelijkheidsinstructie ophalen

Eerst krijgen we de mogelijkheidsinstructie voor uw Azure API for FHIR.

Open Postman.
Haal de mogelijkheidsinstructie op met behulp van GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata. In de onderstaande afbeelding is de FHIR-servernaam fhirserver.

Mogelijkheidsinstructie

Vervolgens proberen we een patiënt op te halen. Als u een patiënt wilt ophalen, gebruikt u GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. U krijgt een 401 Unauthorized foutmelding omdat u niet hebt bewezen dat u toegang moet hebben tot patiëntgegevens.

Mislukte patiënt

Patiënt ophalen van FHIR-server

Als u toegang wilt krijgen, hebt u een toegangstoken nodig.

Selecteer Autorisatie en stel het type in op OAuth2.0 in Postman.
Selecteer Nieuw toegangstoken ophalen.
Vul de velden in en selecteer Token aanvragen. Hieronder ziet u de waarden voor elk veld voor deze zelfstudie.

Veld	Waarde
Tokennaam	Een naam voor uw token
Toekenningstype	Autorisatiecode
URL voor aanroep	https://www.getpostman.com/oauth2/callback
URL van autorisatie	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/?resource=https://<FHIR-SERVER-NAME.azurehealthcareapis.com>
Toegangstoken-URL	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/token
Client ID	De client-id die u tijdens de vorige stappen hebt gekopieerd
Clientgeheim	<BLANCO>
Bereik	<BLANCO>
Provincie	1234
Clientauthenticatie	Clientreferenties in hoofdtekst verzenden

Meld u aan met uw referenties en selecteer Accepteren
Schuif omlaag in het resultaat en selecteer Token gebruiken
Selecteer Opnieuw verzenden bovenaan en deze keer krijgt u een resultaat:

Geslaagde patiënt

Een patiënt in FHIR-server plaatsen

Nu u toegang hebt, kunt u een nieuwe patiënt maken. Hier volgt een voorbeeld van een eenvoudige patiënt die u kunt toevoegen aan uw FHIR-server. Voer dit json in de sectie Hoofdtekst van Postman in.

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

Deze POST maakt een nieuwe patiënt in uw FHIR-server met de naam James Tiberious Kirk.

Patiënt plaatsen

Als u de GET-opdracht gebruikt om een patiënt opnieuw op te halen, ziet u James Tiberious Kirk in de uitvoer.

Notitie

Wanneer u aanvragen verzendt naar de Azure API for FHIR, moet u ervoor zorgen dat u de header van het inhoudstype hebt ingesteld op application/json

Toegangsproblemen oplossen

Er treedt een 403-fout op tijdens het openen van de patiëntresource van Postman.

Controleer of de rol FHIR-inzender is toegewezen; Als dit niet het is, voegt u de rol FHIR-inzender toe aan Azure Health Data Services. Azure RBAC-rollen configureren voor AHDS

Als u tijdens een van deze stappen problemen ondervindt, raadpleegt u de documenten die we hebben samengesteld op Microsoft Entra ID en de Azure API for FHIR.

Microsoft Entra ID en Azure API for FHIR : dit document bevat een overzicht van enkele basisbeginselen van Microsoft Entra-id en hoe deze communiceert met de Azure API for FHIR.
Validatie van toegangstoken: deze instructiegids bevat meer specifieke details over de validatie van het toegangstoken en de stappen die u moet ondernemen om toegangsproblemen op te lossen.

Volgende stappen

Nu u verbinding kunt maken met uw clienttoepassing, bent u klaar om uw webtoepassing te schrijven.

Een webtoepassing schrijven

Notitie

FHIR® is een geregistreerd handelsmerk van HL7 en wordt gebruikt met de machtiging HL7.

Delen via