Introduction

The Drug Analysis APIs are also accessible following the CDS Hooks standard. Developed as an extension of HL7 FHIR, CDS Hooks is a standard protocol for querying clinical decision support systems. Being CDS Hooks compatible means being compatible with all systems implementing the standard.

The technical and functional specifications are described in the official documentation. This document specifies the elements specific to the Posos implementation.

API Availability

This API is available behind the same authentication system as our other APIs, relying on a JWT token. Refer to the page Secure Authentication on the POSOS API. However, the client ID to use for the audience field will be specific to this API and is detailed below.

The base URL of the API depends on the environment:

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

The Client ID also depends on the environment:

Note: Client IDs for the CDS Hooks API are provisioned per customer. Contact your Posos integration contact to obtain your Client IDs for preprod and production environments.

Available Hooks and Services

The following services are currently available:

Implementation Coverage and Limitations

Currently, the use of prefetch is mandatory, and its content/format is specifically documented.

Reference for available services

Service aort

Hook: order-select

This service checks for drug-drug interactions when a new medication is being ordered. It leverages the same interaction analysis engine as the Interactions API.

Prefetch Requirements

The prefetch field is mandatory in all requests. It must include the MedicationRequest resources for the drugs to analyze:

{
  "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": []
    }
  }
}

Response

The service returns CDS Hooks cards for each detected interaction, following the standard CDS Hooks response format.

Note: Detailed prefetch schema documentation and additional services are under active development. For the latest service specifications, contact your Posos integration contact.