Instructions pour l’utilisation de Postman

Guide officiel sur Postman : https://learning.postman.com/docs/introduction/overview/

Postman est un outil en ligne qui vous aidera à mettre à l’essai des API RESTful et à établir des communications avec celles-ci. Nous y avons créé une collection pour faciliter l’intégration aux API REST FHIR. Vous pouvez vous en servir pour authentifier, interroger, récupérer ou chercher des données sur le serveur terminologique. Certaines fonctionnalités, comme la modification des données, sont réservées aux personnes possédant un certain type d’accès. Consultez la collection, et utilisez les modèles pour concevoir le script de votre application logicielle qui s’intègre à nos API. Il existe un dépôt GitHub contenant la collection Postman sous forme de fichier à importer dans votre espace de travail. Voir les détails ci-dessous. Les présentes instructions visent à vous aider à commencer à utiliser Postman. Pour des instructions et une liste des fonctionnalités disponibles à jour, consultez la documentation officielle sur Postman.

Dépôt GitHub

Vous pouvez accéder à la collection Postman à partir de notre dépôt GitHub et l’importer dans votre espace de travail personnel sur Postman afin d’y apporter les modifications souhaitées.  

[Dépôt GitHub] https://github.com/terminologystandardsservice/public

Obtenir un jeton d’authentification dans Postman

Avant de pouvoir interroger les API FHIR, vous devez obtenir un jeton d’authentification (ou d’accès). Vous pouvez utiliser votre nom d’utilisateur et votre mot de passe pour le serveur terminologique, ou utiliser un compte de système.

Compte personnel

• Connectez-vous à Postman.
• Rendez-vous à la collection créée à partir d’un embranchement.
• Cliquez sur Terminology Standards Service Collection.
• Cliquez sur l’onglet Authorization.
• Si vous utilisez Postman sur un ordinateur de bureau, ajoutez l’URL de rappel suivante : https://oauth.pstmn.io/v1/browser-callback
• Tout au bas de la page, cliquez sur le bouton Get new Access Token.
• Vous arriverez à la page de connexion. 
• Entrez votre nom d’utilisateur et votre mot de passe. 
• Une fenêtre avec le message Authentication complete s’affichera.
• Cliquez sur Proceed. 
• Cliquez sur Use Token.
• Vous pouvez maintenant naviguer d’un exemple à l’autre et utiliser le bouton Send pour obtenir une réponse du serveur terminologique.

Compte de système

• La marche à suivre pour utiliser un compte de système ressemble à celle utilisée avec un compte personnel.
• Connectez-vous à Postman.
• Rendez-vous à la collection créée à partir d’un embranchement Terminology Standards Service Collection.
• Cliquez sur l’onglet Authorization.
• Sous Grant type, sélectionnez Client Credentials.
• Entrez l’identifiant et l’authentifiant de client dans les champs appropriés.
• Cliquez sur le bouton Get new Access Token.

Consultez la documentation officielle sur Postman pour obtenir de l’aide ou des instructions plus détaillées.