Appels des APIs
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.
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.