Dela via

Få åtkomst till Azure Health Data Services med hjälp av REST-klienttillägget i Visual Studio Code

  • Artikel

I den här artikeln får du lära dig hur du får åtkomst till Azure Health Data Services med hjälp av REST-klienttillägget i Visual Studio Code.

Installera REST-klienttillägg

Välj tilläggsikonen på den vänstra panelen i Visual Studio Code och sök efter "REST Client". Leta upp REST-klienttillägget och installera.

REST Client VSCode extension

Skapa en .http fil och definiera variabler

Skapa en ny fil i Visual Studio Code. Ange en GET kommandorad för begäran i filen och spara den som test.http. Filsuffixet .http aktiverar automatiskt REST-klientmiljön. Välj Send Request för att hämta metadata.

Send Request

Hämta klientprogramvärden

Viktigt!

Innan du anropar REST-API:et för FHIR-servern (förutom att hämta metadata) måste du slutföra programregistreringen. Anteckna ditt Azure-klient-ID, klient-ID, klienthemlighet och tjänstens URL.

Även om du kan använda värden som klient-ID direkt i anrop till REST-API:et är det en bra idé att definiera några variabler för dessa värden och använda variablerna i stället.

I filen test.http ska du inkludera följande information som hämtats från registreringen av ditt program:

### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....

Hämta Microsoft Entra-åtkomsttoken

När du har inkluderat informationen nedan i test.http filen trycker du på Send Request. Du ser ett HTTP-svar som innehåller din åtkomsttoken.

Raden som börjar med @name innehåller en variabel som avbildar HTTP-svaret som innehåller åtkomsttoken. Variabeln , @tokenanvänds för att lagra åtkomsttoken.

Kommentar

För grant_typeclient_credentials används för att hämta en åtkomsttoken.

### Get access token 
# @name getAADToken 
POST https://login.microsoftonline.com/{{tenantid}}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&resource={{fhirurl}}
&client_id={{clientid}}
&client_secret={{clientsecret}}

### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}

Get access token

Kommentar

I scenarier där FHIR-tjänstens målgruppsparameter inte mappas till FHIR-tjänstens slutpunkts-URL. Värdet för resursparametern ska mappas till målgruppsvärdet under bladet FHIR-tjänstautentisering.

GET FHIR-patientdata

Nu kan du få en lista över patienter eller en specifik patient med GET begäran. Raden med Authorization är rubrikinformationen GET för begäran. Du kan också skicka PUT eller POST begära att skapa/uppdatera FHIR-resurser.

### GET Patient 
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}

GET Patient

Köra PowerShell eller CLI

Du kan köra PowerShell- eller CLI-skript i Visual Studio Code. Tryck CTRL på och välj ~ PowerShell eller Bash. Du hittar mer information om integrerad terminal.

PowerShell i Visual Studio Code

running PowerShell

CLI i Visual Studio Code

running CLI

Felsökning

Om du inte kan hämta metadata, som inte kräver åtkomsttoken baserat på HL7-specifikationen, kontrollerar du att FHIR-servern körs korrekt.

Om du inte kan hämta en åtkomsttoken kontrollerar du att klientprogrammet är korrekt registrerat och att du använder rätt värden från programregistreringssteget.

Om du inte kan hämta data från FHIR-servern kontrollerar du att klientprogrammet (eller tjänstens huvudnamn) har beviljats åtkomstbehörigheter som "FHIR-datadeltagare" till FHIR-servern.

Nästa steg

I den här artikeln har du lärt dig hur du kommer åt Azure Health Data Services-data med hjälp av REST-klienttillägget i Visual Studio Code.

Mer information om hur du verifierar FHIR-resurser mot profiler i Azure Health Data Services finns i

Verifiera FHIR-resurser mot profiler i Azure Health Data Services

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