Introduction

Les APIs d’analyse médicamenteuse sont aussi accessible suivant la norme CDS-Hooks. Mis au point dans la continuité de HL7 FHIR, CDS Hooks est un protocole standard d’interrogation de système d’aide à la décision clinique. Etre compatible CDS-Hooks, c’est ainsi être compatible avec l’ensemble des systèmes implémentant la norme.

Les spécifications techniques et fonctionnelles sont décrites dans la documentation officielle. Ce document précise les éléments spécifiques à l’implémentation par Posos.

Disponibilité de l’API

C’est une API disponible derrière le même système d’authentification que nos autres API, se reposant sur un jeton JWT. Consultez la page Authentification sécurisée sur l’API POSOS. Le client ID à utiliser pour le champs audience sera néanmoins spécifique à cette API et est précisé ci-dessous.

L’URL de base de l’API dépend de l’environnement:

https://cds-hooks.preprod.posos.co

Le Client ID dépend aussi de l’environnement:

Note : Les Client IDs pour l’API CDS Hooks sont provisionnés par client. Contactez votre correspondant technique Posos pour obtenir vos Client IDs pour les environnements preprod et production.

Points d’accroche et services disponibles

Aujourd’hui sont disponibles les services suivants:

Couverture de l’implémentation et limitations

Aujourd’hui, l’usage du prefetch est impératif et son contenu/format est documenté spécifiquement.

Référence des services disponibles

Service aort

Hook : order-select

Ce service vérifie les interactions médicamenteuses lors de la prescription d’un nouveau médicament. Il s’appuie sur le même moteur d’analyse que l’API Interactions.

Prérequis Prefetch

Le champ prefetch est obligatoire dans toutes les requêtes. Il doit inclure les ressources MedicationRequest des médicaments à analyser :

{
  "hook": "order-select",
  "hookInstance": "<unique-id>",
  "context": {
    "userId": "Practitioner/<id>",
    "patientId": "Patient/<id>",
    "selections": ["MedicationRequest/<id>"],
    "draftOrders": {
      "resourceType": "Bundle",
      "entry": []
    }
  },
  "prefetch": {
    "medications": {
      "resourceType": "Bundle",
      "entry": []
    }
  }
}

Réponse

Le service retourne des cards CDS Hooks pour chaque interaction détectée, suivant le format de réponse standard CDS Hooks.

Note : La documentation détaillée du schéma prefetch et les services additionnels sont en cours de développement. Pour les dernières spécifications de service, contactez votre correspondant technique Posos.