Catalogue des APIs

Cette page recense les APIs Posos documentées pour les intégrations clients. Leur accès dépend du contrat, de l’environnement et de la région. Certaines extensions partenaires et certains services internes sont documentés séparément.

URLs de base :

Preprod : https://api.preprod.posos.co

Production : https://api.production.posos.co

Régions et endpoints

Les conventions de région varient selon le service. MedicalDB utilise notamment un endpoint distinct pour la Belgique.

Service	Endpoint	France	Belgique
AORT	/aort-api-v3/v1/graphql	?region=fr-FR	?region=fr-BE
ARP	/arp-api-v2/v1/graphql	?region=fr-FR	?region=fr-BE
AAE	/aae-api/v1/graphql	?region=fr-FR	?region=fr-BE
Autocomplétion	/autocomplete-api/autocomplete	?locale=fr_FR	?locale=fr_BE
NERL	/nerl/v2/nerl	?lang=fr	?lang=fr
MedicalDB (BIM)	/bim-v2/v1/graphql	/bim-v2/v1/graphql	/bim-be-v2/v1/graphql

API d’analyse

API d’aide à la décision clinique qui analysent les prescriptions pour la sécurité et l’optimisation.

Les trois services GraphQL utilisent un paramètre region. La matrice détaille les fonctions disponibles en France et en Belgique. Ils acceptent aussi region=nl-BE, qui offre les mêmes fonctions que la Belgique avec des textes en néerlandais (voir régions et marchés).

Fonctionnalité	France	Belgique
Contre-indications	✓	✓
Alertes de conduite	✓	✓
Alertes antidopage	✓	✓
Recommandations thérapeutiques	✓	✓
Système d'aide à la décision (HAS)	✓	N/A
Interactions médicamenteuses	✓	✓
Allergies	✓	✓
Effets indésirables	✓	✓
Compatibilités physico-chimiques	✓	N/A
Conditions de prescription	✓	N/A
Analyse posologique	✓	✓
Coût de prescription	✓	✓
Duplication thérapeutique	✓	✓
Calculateurs cliniques	✓	✓
Critères biologiques	✓	✓
Critères post-arrêt	✓	✓
Ajustement de dose	✓	N/A
Surveillance pré-traitement	N/A	✓
Charge anticholinergique	✓	✓

AORT — Analyse de Prescription et Recommandation Thérapeutique

post/aort-api-v3/v1/graphql

API	Requête	Description
Interactions	`getInteractions`	Vérification des interactions médicamenteuses
Contre-indications	`getContraindications`	Détection des contre-indications selon le profil patient
Effets indésirables	`getAdverseEffects`	Liste des effets indésirables des médicaments
Allergie	`getAllergyIntolerance`	Détection des réactions allergiques dans une liste de médicaments
Recommandation thérapeutique	`getAlternatives`	Recommandation d’alternatives pour une indication donnée
Indications	`getIndications`	Indications cliniques d’une liste de médicaments
Aide à la décision indexée au médicament (HAS)	`getSam`	Récupération des alertes SAM de la HAS
Calculateurs	`getCalc`	Calculs cliniques
Compatibilité physico-chimique	`getCompatibility`	Vérification de la compatibilité physico-chimique entre médicaments
Critères biologiques	`getBiologicalCriteria`	Critères biologiques à surveiller pour un médicament
Critères après arrêt	`getPostStopCriteria`	Critères cliniques à surveiller après l’arrêt d’un médicament
Charge anticholinergique	`getAnticholinergicLoads`	Charge anticholinergique d’une liste de médicaments, par échelle
Libellé de dispositif médical	`getMedicalDeviceLabel`	Libellé d’un dispositif médical à partir de son code

GraphiQL AORT

ARP — Analyse Posologique

post/arp-api-v2/v1/graphql

API	Requête	Description
Alertes posologiques	`getDosageAlert`	Détection des problèmes de posologie (surdosage, sous-dosage, durée)
Duplication thérapeutique	`getTherapeuticDuplication`	Détection de redondance de substance active
Éligibilité à l’ajustement posologique	`getDoseAdjustmentEligibility`	Éligibilité d’un médicament prescrit à un ajustement rapide de dose
Combinaison de spécialités	`getDoseCombination`	Combinaison de spécialités atteignant exactement une dose cible par prise
Quantité de substance active	`getActiveSubstanceQuantity`	Quantité de substance active par jour, par semaine et par mois
Libellé de dispositif médical	`getMedicalDeviceLabel`	Libellé d’un dispositif médical à partir de son code

GraphiQL ARP

AAE — Analyse Administrative et Economique

post/aae-api/v1/graphql

API	Requête	Description
Unités de dosage	`getDosageUnits`	Récupération des unités de dosage pour une prescription
Coût de prescription	`getPrescriptionCost`	Calcul du coût total d’une prescription
Conditions de prescription	`getRestrictedPrescriptions`	Récupération des conditions de prescription restreinte

GraphiQL AAE

API NLP

Traitement du langage naturel pour la recherche de médicaments et le parsing de posologies.

API	Endpoint	Méthode	Description
Autocomplétion	`/autocomplete-api/autocomplete`	GET	Recherche de médicaments, ingrédients, indications et entités médicales
NERL	`/nerl/v2/nerl`	GET	Extraction et liaison d’entités médicales à partir d’un texte (médicaments, posologies, indications…)
Structuration de posologie	`/nerl/v2/nerl`	GET	Structuration d’une posologie en texte libre
Reconstruction de posologie	`/nerl/v2/poso_reconstructor`	POST	Reconstruction de posologie à partir de données structurées vers du texte libre
Structuration de prescription	`/nerl/v3/prescription`	POST	Analyse d’une prescription complète et extraction des éléments prescrits (Preview)

Playground API

Scan d’ordonnance

API	Endpoint	Méthode	Description
Scan d’ordonnance	`/scanordo/v2/scan-ordo`	POST	Extraction de données structurées à partir d’images/PDF d’ordonnances (retourne un Bundle FHIR)
Détection des posologies complexes	`/scanordo/v2/scan-ordo`	POST	Détection des posologies qui nécessitent une validation, avec `detect_complex_posology=true`

Partner Connect

API pour l’intégration contextuelle des fonctionnalités Posos dans les logiciels partenaires.

API	Endpoint	Méthode	Description
Appel contextuel	`/api/partners/proxy/prepare`	POST	Ouverture d’un guide Posos avec contexte patient pré-chargé
Scan & Go	`/api/partners/patient/scan-token`	POST	Obtention d’une URL pour l’import et la validation d’ordonnance
QR Code	`/api/partners/patient/qrcode`	GET	Génération d’un QR Code lié à un dossier patient

MedicalDB (BIM)

post/bim-v2/v1/graphql

Une base de données médicamenteuse complète couvrant médicaments cliniques, spécialités, ingrédients, indications, interactions, prix et bien plus.

Pour démarrer Explorateur GraphQL MedicalDB

API basées sur les standards

API	Endpoint	Protocole	Description
CDS Hooks	`https://cds-hooks.{env}.posos.co`	CDS Hooks	Standard HL7 CDS Hooks pour la vérification d’interactions médicamenteuses
Entrepôt FHIR	`https://fhir.production.trusted.posos.co/fhir/r4/:slug`	FHIR R4	Accès en lecture seule aux prescriptions scannées

Serveur MCP

API	Endpoint	Protocole	Description
Serveur MCP Posos	`https://mcp.production.posos.co/api/v1/mcp`	MCP sur HTTP	Accès OAuth aux outils Posos pour les assistants IA

Widgets

Composants UI intégrables pour l’aide à la décision clinique.

API	Endpoint	Méthode	Description
Authentification utilisateur	`/api/v1/admin/token`	POST	Génération de jetons d’accès pour les utilisateurs de widgets

Documentation des widgets

Configuration requise Par jeton d'identité Google (Legacy)