Appels des APIs
Plusieurs APIs sont à disposition afin de récupérer ou structurer des données médicales.
Introduction
Les APIs de Posos permettent de structurer du texte médical non-structuré (ordonnance, paragraphes, etc.). Par structuration on entend l’identification des entités médicales (médicaments, posologies, pathologies etc.) et la normalisation de ces entités vers des ontologies médicales (ATC, UCD, SNOMED, etc.). Les APIs permettent également de faire de l’aide à la décision clinique en proposant des alternatives thérapeutiques, des interactions médicamenteuses, des indications, etc.
Comment ça fonctionne ?
L’intégration repose sur des appels HTTP vers nos serveurs. Ces appels sont sécurisés par un jeton d’identité (JWT).
Autorisation
L’application demande un jeton d’identité à l’API d’authentification (voir Authentification par jeton d’identité)
Bon à savoir : La clé privée de compte de service est différente pour chaque environnement. Nous vous transmettrons la clé de
productionune fois les tests terminés.
Appel de l’API
L’application appelle l’API de son choix en passant le jeton d’identité dans le header Authorization de la requête HTTP en mode Bearer, ainsi que les en-têtes x-posos-user-id et x-posos-facility-id qui identifient l’utilisateur et l’établissement pour lesquels la requête est effectuée (voir Identification de l’utilisateur et de l’établissement).
Une réponse au format JSON est retournée par l’API.
URL des appels APIs
L’url de base est https://api.{env}.posos.co où {env} est l’environnement suivant : preprod pour la validation, production pour le live.
https://api.preprod.posos.coAPIs diponibles
Nous distinguons trois types d’APIs :
Analyse d’ordonnance et recommandation de traitements
Ces APIs permettent de récupérer des alternatives thérapeutiques, des interactions médicamenteuses, des indications mais aussi des effets indésirables.
Structuration de texte médical
Ces APIs permettent de structurer du texte médical non-structuré (ordonnance, paragraphes, etc.). Par structuration on entend l’identification des entités médicales (médicaments, posologies, pathologies etc.) et la normalisation de ces entités vers des ontologies médicales (ATC, UCD, SNOMED, etc.).
Structuration de texte médical
Scan d’ordonnance
Cette API permet de convertir une ordonnance tapuscrite en ordonnance structurée au format FHIR.
Prochaines étapes
Ces pages vous permettront de comprendre en détail comment fonctionnent les APIs de Posos.
Dernière mise à jour le