De FHIR-API testen in Azure API for FHIR

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.

Mogelijkheidsinstructie ophalen

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

1. Open Postman.
2. Haal de mogelijkheidsinstructie op door dit te doen GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata. In de onderstaande afbeelding is de FHIR-servernaam fhirserver.

Vervolgens proberen we een patiënt op te halen. Als u een patiënt wilt ophalen, voert u in GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. U ontvangt een fout 401 Niet-geautoriseerd. Deze fout ontstaat omdat u niet hebt bewezen dat u toegang mag hebben tot patiëntgegevens.

Patiënt ophalen van FHIR-server

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

1. Selecteer Autorisatie en stel het type in op OAuth2.0 in Postman.
2. Selecteer Nieuw toegangstoken ophalen.
3. 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

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

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"
    }

Met deze POST wordt een nieuwe patiënt in uw FHIR-server gemaakt met de naam James Tiberious Kirk.

Als u de GET-opdracht uitvoert 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

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

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