Testa FHIR-API:et i Azure API för FHIR

Artikel
12/04/2024

Viktigt!

Azure API för FHIR avvecklas den 30 september 2026. Följ migreringsstrategierna för att övergå till Azure Health Data Services FHIR-tjänsten® senast det datumet. På grund av tillbakadragandet av Azure API för FHIR tillåts inte nya distributioner från och med den 1 april 2025. Azure Health Data Services FHIR-tjänsten är den utvecklade versionen av Azure API för FHIR som gör det möjligt för kunder att hantera FHIR-, DICOM- och MedTech-tjänster med integreringar i andra Azure-tjänster.

I den föregående självstudien distribuerade du Azure API för FHIR® och registrerade klientprogrammet. Nu är du redo att testa ditt Azure API för FHIR.

Hämta funktionssatsen

Först får vi funktionsuttryck för ditt Azure API för FHIR.

Öppna Postman.
Hämta funktionssatsen med hjälp GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadataav . I avbildningen nedanför är FHIR-servernamnet fhirserver.

Funktionsinstruktor

Nu försöker vi hämta en patient. Om du vill hämta en patient använder du GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. Du får ett 401 Unauthorized fel eftersom du inte har bevisat att du ska ha åtkomst till patientdata.

Misslyckad patient

Hämta patienten från FHIR-servern

För att få åtkomst behöver du en åtkomsttoken.

Välj Auktorisering och ange Typ till OAuth2.0 i Postman.
Välj Hämta ny åtkomsttoken.
Fyll i fälten och välj Begär token. Nedan kan du se värdena för varje fält för den här självstudien.

Fält	Värde
Tokennamn	Ett namn på din token
Bevilja typ	Auktoriseringskod
Återanrops-URL	https://www.getpostman.com/oauth2/callback
Autentiserings-URL	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/?resource=https://<FHIR-SERVER-NAME.azurehealthcareapis.com>
Åtkomsttoken URL	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/token
Client ID	Det klient-ID som du kopierade under föregående steg
Klienthemlighet	<BLANK>
Omfattning	<BLANK>
Tillstånd	1234
Klientautentisering	Skicka klientautentiseringsuppgifter i brödtext

Logga in med dina autentiseringsuppgifter och välj Acceptera
Rulla nedåt på resultatet och välj Använd token
Välj Skicka igen överst och den här gången bör du få ett resultat:

Lyckad patient

Skicka patienten till FHIR-servern

Nu när du har åtkomst kan du skapa en ny patient. Här är ett exempel på en enkel patient som du kan lägga till i din FHIR-server. Ange detta json i avsnittet Brödtext i Postman.

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

Detta POST skapar en ny patient i din FHIR-server med namnet James Tiberious Kirk.

Post Patient

Om du använder GET-kommandot för att hämta en patient igen visas James Tiberious Kirk i utdata.

Kommentar

När du skickar begäranden till Azure API för FHIR måste du se till att du har angett innehållstyprubriken till application/json

Felsöka åtkomstproblem

Får ett 403-fel när du försöker komma åt patientresursen från Postman.

Kontrollera om rollen FHIR-deltagare har tilldelats. Om det inte är det lägger du till rollen FHIR-deltagare i Azure Health Data Services. Konfigurera Azure RBAC-roller för AHDS

Om du stöter på problem under något av de här stegen granskar du de dokument som vi har sammanställt i Microsoft Entra-ID och Azure API för FHIR.

Microsoft Entra-ID och Azure API för FHIR – Det här dokumentet beskriver några av de grundläggande principerna för Microsoft Entra-ID och hur det interagerar med Azure API för FHIR.
Validering av åtkomsttoken – Den här guiden ger mer specifik information om validering av åtkomsttoken och åtgärder för att lösa åtkomstproblem.

Nästa steg

Nu när du kan ansluta till klientprogrammet är du redo att skriva webbappen.

Skriva ett webbprogram

Kommentar

FHIR® är ett registrerat varumärke som tillhör HL7 och används med tillstånd av HL7.

Dela via