Accès à Azure Health Data Services à l’aide de l’extension client REST dans Visual Studio Code
Dans cet article, vous allez apprendre à accéder à Azure Health Data Services à l’aide de l’extension client REST dans Visual Studio Code.
Installer l’extension client REST
Sélectionnez l’icône Extensions dans le volet gauche de votre Code Visual Studio, puis recherchez « Client REST ». Recherchez l’extension client REST et installez.
Créer un .http fichier et définir des variables
Créez un fichier dans Visual Studio Code. Entrez une GET ligne de commande de demande dans le fichier, puis enregistrez-la sous test.http. Le suffixe .http de fichier active automatiquement l’environnement client REST. Sélectionnez cette option Send Request pour obtenir les métadonnées.
Obtenir des valeurs d’application cliente
Important
Avant d’appeler l’API REST du serveur FHIR (autre que d’obtenir les métadonnées), vous devez terminer l’inscription de l’application. Notez votre ID de locataire Azure, l’ID client, la clé secrète client et l’URL du service.
Bien que vous puissiez utiliser des valeurs telles que l’ID client directement dans les appels à l’API REST, il est recommandé de définir quelques variables pour ces valeurs et d’utiliser les variables à la place.
Dans votre test.http fichier, incluez les informations suivantes obtenues lors de l’inscription de votre application :
### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....
Obtenir le jeton d’accès Microsoft Entra
Après avoir inclus les informations ci-dessous dans votre test.http fichier, appuyez sur Send Request. Vous verrez une réponse HTTP qui contient votre jeton d’accès.
La ligne commençant par @name contient une variable qui capture la réponse HTTP contenant le jeton d’accès. La variable, est @tokenutilisée pour stocker le jeton d’accès.
Remarque
Celui-ci grant_typeclient_credentials est utilisé pour obtenir un jeton d’accès.
### 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}}
Remarque
Dans les scénarios où le paramètre d’audience du service FHIR n’est pas mappé à l’URL du point de terminaison de service FHIR. La valeur du paramètre de ressource doit être mappée à la valeur Audience sous le panneau Authentification du service FHIR.
GET Données du patient FHIR
Vous pouvez maintenant obtenir une liste de patients ou d’un patient spécifique avec la GET demande. La ligne avec Authorization est les informations d’en-tête de la GET requête. Vous pouvez également envoyer PUT ou POST demander de créer/mettre à jour des ressources FHIR.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
Exécuter PowerShell ou CLI
Vous pouvez exécuter des scripts PowerShell ou CLI dans Visual Studio Code. Appuyez CTRL sur la ~ touche et sélectionnez PowerShell ou Bash. Vous trouverez plus d’informations sur le terminal intégré.
PowerShell dans Visual Studio Code
INTERFACE CLI dans Visual Studio Code
Résolution des problèmes
Si vous ne parvenez pas à obtenir les métadonnées, qui ne nécessitent pas de jeton d’accès en fonction de la spécification HL7, case activée que votre serveur FHIR s’exécute correctement.
Si vous ne parvenez pas à obtenir un jeton d’accès, vérifiez que l’application cliente est inscrite correctement et que vous utilisez les valeurs correctes de l’étape d’inscription de l’application.
Si vous ne parvenez pas à obtenir des données à partir du serveur FHIR, vérifiez que l’application cliente (ou le principal de service) a reçu des autorisations d’accès telles que « Contributeur de données FHIR » au serveur FHIR.
Étapes suivantes
Dans cet article, vous avez appris à accéder aux données Azure Health Data Services à l’aide de l’extension REST Client dans Visual Studio Code.
Pour en savoir plus sur la validation des ressources FHIR par rapport aux profils dans Azure Health Data Services, consultez
FHIR® est une marque déposée de HL7 utilisé avec l’autorisation de HL7.