Accéder à Services de données de santé Azure en utilisant l’extension Client REST dans Visual Studio Code
Dans cet article, vous découvrez comment accéder à Services de données de santé Azure en utilisant l’extension Client REST dans Visual Studio Code.
Installer l’extension Client REST
Sélectionnez l’icône Extensions dans le volet gauche de Visual Studio Code, puis recherchez « Client REST ». Recherchez l’extension Client REST et installez-la.
Créer un fichier .http et définir des variables
Créez un fichier dans Visual Studio Code. Entrez une ligne de commande de requête GET dans le fichier, puis enregistrez-le en tant que test.http. Le suffixe de fichier .http active automatiquement l’environnement Client REST. Sélectionnez Send Request pour obtenir les métadonnées.
Obtenir des valeurs de l’application cliente
Important
Avant d’appeler l’API REST du serveur FHIR® (s’il ne s’agit pas d’obtenir les métadonnées), vous devez effectuer l’inscription d’application. Prenez note de votre ID de locataire Azure, de votre ID client, de votre secret client et de l’URL du service.
Vous pouvez utiliser des valeurs comme l’ID client directement dans les appels à l’API REST, mais c’est une bonne pratique que de définir quelques variables pour ces valeurs et d’utiliser ces variables à la place.
Dans votre fichier test.http, 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 suivantes dans votre fichier test.http, cliquez 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, @token, est utilisée pour stocker le jeton d’accès.
Remarque
Le grant_type de client_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}}
&scope={{fhirurl}}/.default
### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}
Remarque
Quand 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 de Audience sous le panneau Authentification du service FHIR.
Obtenir les données du patient FHIR
Vous pouvez maintenant obtenir une liste de patients ou un patient spécifique avec la requête GET. La ligne avec Authorization correspond aux informations d’en-tête pour la requête GET. Vous pouvez également envoyer des requêtes PUT ou POST pour créer et mettre à jour des ressources FHIR.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
Exécuter PowerShell ou l’interface CLI
Vous pouvez exécuter des scripts PowerShell ou CLI dans Visual Studio Code. Appuyez sur CTRL et sur la touche ~, puis sélectionnez PowerShell ou Bash. Vous pouvez trouver plus d’informations sur le terminal intégré.
PowerShell dans Visual Studio Code
Interface CLI dans Visual Studio Code
Dépannage
Si vous ne parvenez pas à obtenir les métadonnées (ce qui ne nécessite pas de jeton d’accès, selon la spécification HL7), vérifiez 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 provenant de l’étape d’inscription de l’application.
Si vous ne parvenez pas à obtenir des données auprès 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 » pour le serveur FHIR.
Étapes suivantes
Dans cet article, vous avez découvert comment accéder aux données de Services de données de santé Azure en utilisant l’extension Client REST dans Visual Studio Code.
Pour découvrir comment valider des ressources FHIR pour des profils dans Services de données de santé Azure, consultez
Remarque
FHIR® est une marque déposée de HL7 utilisé avec l’autorisation de HL7.