Få åtkomst till Azure Health Data Services med hjälp av REST-klienttillägget i Visual Studio Code
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.
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.
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 , @token
används för att lagra åtkomsttoken.
Kommentar
För grant_type
client_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}}
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}}
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
CLI i Visual Studio Code
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
FHIR® är ett registrerat varumärke som tillhör HL7 och används med tillstånd av HL7.
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för