Developer · REST API

L'API pour le diagnostic de laboratoire : commander, suivre, recevoir les résultats

L'API Probatix est une interface REST qui couvre l'ensemble du workflow diagnostique : commander des kits de test, suivre le statut logistique et laboratoire via webhooks et recevoir les comptes rendus en bundle FHIR R4 avec des valeurs codées LOINC. Une seule intégration – de la commande du kit au résultat structuré.

REST FHIR R4 LOINC Webhooks <48h de délai de résultat
Le déroulement

Déroulement d'une intégration

Quatre étapes, un seul flux de données : votre système dialogue exclusivement avec l'API Probatix – fulfillment, laboratoires et logique de compte rendu restent masqués derrière elle.

01

Créer la commande

Votre système crée un ordre de test par appel REST – avec la variante de kit, le panel et l'adresse de livraison. Probatix valide les champs requis et lance le fulfillment.

REST JSON
02

Recevoir les événements logistiques

Expédition, livraison, retour de l'échantillon et réception au laboratoire : chaque changement de statut est signalé par webhook à votre système – sans polling.

Webhooks Suivi
03

Recevoir le webhook de résultat

Dès que le compte rendu est validé médicalement, un webhook notifie votre système en temps réel. Vous décidez quand et comment l'utilisateur final est informé.

Temps réel Piloté par événements
04

Récupérer le compte rendu

Le compte rendu est disponible en JSON structuré ou en bundle FHIR R4 – DiagnosticReport et Observations, codés LOINC, avec plages de référence.

FHIR R4 LOINC
FHIR R4

À quoi ressemble un compte rendu

Exemple abrégé et générique d'un compte rendu FHIR R4 : un DiagnosticReport avec une Observation codée LOINC, plage de référence incluse. Les comptes rendus réels contiennent en plus les données Specimen et tous les paramètres du panel.

{
  "resourceType": "DiagnosticReport",
  "status": "final",
  "code": {
    "coding": [{
      "system": "http://loinc.org",
      "code": "24331-1",
      "display": "Lipid 1996 panel - Serum or Plasma"
    }]
  },
  "issued": "2026-08-04T09:30:00+02:00",
  "result": [
    { "reference": "Observation/obs-ldl-example" }
  ]
}

{
  "resourceType": "Observation",
  "id": "obs-ldl-example",
  "status": "final",
  "code": {
    "coding": [{
      "system": "http://loinc.org",
      "code": "13457-7",
      "display": "Cholesterol in LDL [Mass/volume] in Serum or Plasma by calculation"
    }]
  },
  "valueQuantity": {
    "value": 118,
    "unit": "mg/dL",
    "system": "http://unitsofmeasure.org",
    "code": "mg/dL"
  },
  "referenceRange": [{
    "high": { "value": 116, "unit": "mg/dL" }
  }]
}

Authentification

L'accès à l'API se fait via des identifiants personnalisés que vous recevez lors de l'onboarding. Tous les endpoints sont exclusivement accessibles de manière chiffrée via TLS ; les accès sont cloisonnés par client et journalisés de manière auditable.

Documentation & sandbox

Nous mettons à disposition des partenaires la référence API complète, l'environnement de test et des comptes rendus d'exemple lors de l'onboarding. Le chemin le plus rapide : un entretien de démonstration avec notre équipe.

Réserver une démo et demander l'accès API

Pour approfondir dans le centre de savoir

Comment REST, compte rendu FHIR et LOINC s'articulent au quotidien de l'intégration : l'article de savoir Intégrer le diagnostic de laboratoire par API – avec des exemples de workflows pour la télémédecine et les applications de santé. Pour la vue d'ensemble : la plateforme Probatix et le guide DaaS.

Questions fréquentes

API de diagnostic : FAQ

Les quatre questions que les équipes de développement posent le plus souvent avant une intégration.

Quelle version de FHIR est prise en charge ?

Les comptes rendus sont livrés en bundle FHIR R4 – avec DiagnosticReport, Observation et Specimen comme ressources centrales. Les paramètres sont codés LOINC, les unités suivent UCUM. Pour les systèmes sans connexion FHIR, le même compte rendu est disponible en JSON structuré.

Existe-t-il des webhooks pour les changements de statut ?

Oui. Tous les changements de statut pertinents – de la création de la commande à l'expédition, la réception de l'échantillon et la validation du compte rendu – déclenchent des webhooks. Votre système reste synchronisé en temps réel, sans interroger l'API périodiquement.

En combien de temps les résultats sont-ils disponibles ?

Pour la plupart des tests, le résultat est disponible dans les 48 heures suivant la réception de l'échantillon au laboratoire. Le webhook de résultat se déclenche immédiatement après la validation médicale du compte rendu.

Existe-t-il un environnement de test ?

Oui. Pour la phase d'intégration, nous mettons à disposition un environnement de test permettant de simuler commandes, changements de statut et comptes rendus d'exemple, sans expédition réelle de kits. Vous obtenez l'accès dans le cadre de l'onboarding – réservez une démo pour cela.

Une API. L'ensemble du workflow diagnostique.

Deep dive technique avec notre équipe : architecture, exemples de payloads et accès sandbox pour votre cas d'usage.