Test de l’API FHIR sur l’API Azure pour FHIR

Article
12/04/2024

Important

L’API Azure pour FHIR sera mise hors service le 30 septembre 2026. Suivez les stratégies de migration pour passer au service FHIR® de Services de données de santé Azure d’ici à cette date. En raison de la mise hors service de l’API Azure pour FHIR, les nouveaux déploiements ne seront plus autorisés à compter du 1er avril 2025. Le service FHIR des Services de données de santé Azure est la version évoluée de l’API Azure pour FHIR qui permet aux clients de gérer les services FHIR, DICOM et MedTech avec des intégrations dans d’autres services Azure.

Dans le tutoriel précédent, vous avez déployé l’API Azure pour FHIR® et inscrit votre application cliente. Vous êtes maintenant prêt à tester votre API Azure pour FHIR.

Extraire l’énoncé de capacité

Tout d’abord, nous allons obtenir l’énoncé de capacité pour votre API Azure pour FHIR.

Ouvrez Postman.
Extrayez l’énoncé de capacité à l’aide de GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata. Dans l’image ci-dessous, le nom du serveur FHIR est fhirserver.

Énoncé de capacité

Ensuite, nous allons essayer d’extraire un patient. Pour extraire un patient, utilisez GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. Vous obtenez une erreur 401 Unauthorized, car vous n’avez pas prouvé que vous étiez habilité à accéder aux données des patients.

Patient en échec

Obtenir un patient auprès du serveur FHIR

Pour obtenir un accès, vous avez besoin d’un jeton d’accès.

Dans Postman, sélectionnez Autorisation et définissez le paramètre Type sur OAuth 2.0.
Cliquez sur Obtenir un nouveau jeton d’accès.
Complétez les champs et sélectionnez Request Token (Demander un jeton). Les valeurs de chaque champ sont indiquées ci-dessous pour les besoins de ce tutoriel.

Champ	Valeur
Token Name (Nom du jeton)	Nom de votre jeton.
Grant Type (Type d’autorisation)	Code d’autorisation
URL de rappel	https://www.getpostman.com/oauth2/callback
URL d’authentification	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/?resource=https://<FHIR-SERVER-NAME>.azurehealthcareapis.com
URL du jeton d’accès	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/token
ID client	ID client que vous avez copié aux étapes précédentes
Clé secrète client	<BLANK>
Étendue	<BLANK>
État	1234
Authentification du client	Envoyer les informations d’identification du client dans le corps

Connectez-vous avec vos informations d’identification, puis sélectionnez Accept (Accepter).
Accédez au bas des résultats, puis sélectionnez Use Token (Utiliser le jeton).
Sélectionnez de nouveau Envoyer dans la partie supérieure, vous devriez cette fois obtenir un résultat :

Patient Réussi

Transmettre le patient au serveur FHIR

Maintenant que vous disposez d’un accès, vous pouvez créer un patient. Voici un exemple de patient simple que vous pouvez ajouter dans votre serveur FHIR. Entrez ce json dans la section Corps de Postman.

    {
        "resourceType": "Patient",
        "active": true,
        "name": [
            {
                "use": "official",
                "family": "Kirk",
                "given": [
                    "James",
                    "Tiberious"
                ]
            },
            {
                "use": "usual",
                "given": [
                    "Jim"
                ]
            }
        ],
        "gender": "male",
        "birthDate": "1960-12-25"
    }

Cette commande POST a pour effet de créer un patient nommé James Tiberious Kirk dans votre serveur FHIR.

Transmission du patient

Si vous utilisez la commande GET pour extraire de nouveau un patient, James Tiberious Kirk apparaît dans la sortie.

Remarque

Lors de l’envoi de requêtes à l’API Azure pour FHIR, vous devez vous assurer que vous avez défini l’en-tête de type de contenu sur application/json

Résolution des problèmes d’accès

Obtention d’une erreur 403 lors de la tentative d’accès à la ressource Patient depuis Postman.

Vérifiez si le rôle Collaborateur FHIR est attribué ; si ce n’est pas le cas, ajoutez ce rôle aux Services de données de santé Azure (AHDS). Configurer des rôles RBAC Azure pour AHDS

Si vous avez rencontré des problèmes à l’une de ces étapes, parcourez les documents sur Microsoft Entra ID et l’API Azure pour FHIR que nous avons réunis.

Microsoft Entra ID et API Azure pour FHIR – Ce document décrit certains principes de base de Microsoft Entra ID ainsi que son interaction avec l’API Azure pour FHIR.
Validation des jetons d’accès – Ce guide pratique fournit des détails plus spécifiques sur la validation des jetons d’accès et sur la façon de résoudre les problèmes d’accès.

Étapes suivantes

Maintenant que vous savez comment vous connecter à votre application cliente, vous êtes prêt à écrire votre application web.

Écrire une application web

Remarque

FHIR® est une marque déposée de HL7 utilisé avec l’autorisation de HL7.

Partager via