Toegang tot Azure Health Data Services met behulp van de REST-clientextensie in Visual Studio Code
In dit artikel leert u hoe u toegang krijgt tot Azure Health Data Services met behulp van de REST-clientextensie in Visual Studio Code.
REST-clientextensie installeren
Selecteer het pictogram Extensies aan de linkerkant van uw Visual Studio Code en zoek naar 'REST Client'. Zoek de REST-clientextensie en installeer deze.
.http Een bestand maken en variabelen definiëren
Maak een nieuw bestand in Visual Studio Code. Voer een GET aanvraagopdrachtregel in het bestand in en sla deze op als test.http. Het bestandsachtervoegsel .http activeert automatisch de REST Client-omgeving. Selecteer Send Request deze optie om de metagegevens op te halen.
Clienttoepassingswaarden ophalen
Belangrijk
Voordat u de REST API van de FHIR-server aanroept (anders dan het ophalen van de metagegevens), moet u de registratie van de toepassing voltooien. Noteer uw Azure-tenant-id, client-id, clientgeheim en de service-URL.
Hoewel u waarden zoals de client-id rechtstreeks in aanroepen naar de REST API kunt gebruiken, is het een goed idee om een paar variabelen voor deze waarden te definiëren en in plaats daarvan de variabelen te gebruiken.
Neem in uw test.http bestand de volgende informatie op die u hebt verkregen bij het registreren van uw toepassing:
### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....
Microsoft Entra-toegangstoken ophalen
Nadat u de onderstaande informatie in uw test.http bestand hebt opgenomen, klikt u op Send Request. U ziet een HTTP-antwoord dat uw toegangstoken bevat.
De regel die begint met @name bevat een variabele waarmee het HTTP-antwoord wordt vastgelegd dat het toegangstoken bevat. De variabele, @tokenwordt gebruikt om het toegangstoken op te slaan.
Notitie
De grant_type van client_credentials wordt gebruikt om een toegangstoken te verkrijgen.
### 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}}
Notitie
In de scenario's waarin de parameter FHIR-servicedoelgroep niet is toegewezen aan de URL van het FHIR-service-eindpunt. De waarde van de resourceparameter moet worden toegewezen aan doelgroepwaarde onder de blade FHIR-serviceverificatie.
GET FHIR Patiëntgegevens
U kunt nu een lijst met patiënten of een specifieke patiënt krijgen met de GET aanvraag. De regel met Authorization is de headergegevens voor de GET aanvraag. U kunt ook aanvragen verzenden of POST aanvragen voor PUT het maken/bijwerken van FHIR-resources.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
PowerShell of CLI uitvoeren
U kunt PowerShell- of CLI-scripts uitvoeren in Visual Studio Code. Druk en druk op CTRL de ~ toets en selecteer PowerShell of Bash. Meer informatie over Integrated Terminal vindt u.
PowerShell in Visual Studio Code
CLI in Visual Studio Code
Problemen oplossen
Als u de metagegevens niet kunt ophalen, waarvoor geen toegangstoken is vereist op basis van de HL7-specificatie, controleert u of uw FHIR-server correct wordt uitgevoerd.
Als u geen toegangstoken kunt ophalen, moet u ervoor zorgen dat de clienttoepassing correct is geregistreerd en u de juiste waarden uit de registratiestap van de toepassing gebruikt.
Als u geen gegevens van de FHIR-server kunt ophalen, moet u ervoor zorgen dat de clienttoepassing (of de service-principal) toegangsmachtigingen heeft gekregen, zoals FHIR-gegevensbijdrager voor de FHIR-server.
Volgende stappen
In dit artikel hebt u geleerd hoe u toegang krijgt tot Azure Health Data Services-gegevens met behulp van de REST-clientextensie in Visual Studio Code.
Zie voor meer informatie over het valideren van FHIR-resources op basis van profielen in Azure Health Data Services
FHIR® is een geregistreerd handelsmerk van HL7 en wordt gebruikt met de machtiging HL7.