Developer · REST API

Die API für Labordiagnostik: bestellen, tracken, Befunde empfangen

Q: Welche FHIR-Version wird unterstützt?

Befunde werden als FHIR-R4-Bundle ausgeliefert – mit DiagnosticReport, Observation und Specimen als zentralen Ressourcen. Die Parameter sind LOINC-codiert, Einheiten folgen UCUM. Für Systeme ohne FHIR-Anbindung steht derselbe Befund als strukturiertes JSON zur Verfügung.

Q: Gibt es Webhooks für Statusübergänge?

Ja. Alle relevanten Statusübergänge – von der Auftragsanlage über Versand und Probeneingang bis zur Befundfreigabe – lösen Webhooks aus. Ihr System bleibt in Echtzeit synchron, ohne die API periodisch abfragen zu müssen.

Q: Wie schnell liegen Ergebnisse vor?

Für die meisten Tests liegt das Ergebnis innerhalb von 48 Stunden nach Probeneingang im Labor vor. Der Ergebnis-Webhook feuert unmittelbar nach der ärztlichen Freigabe des Befunds.

Q: Gibt es eine Testumgebung?

Ja. Für die Integrationsphase stellen wir eine Testumgebung bereit, in der sich Bestellungen, Statusübergänge und Beispielbefunde durchspielen lassen, ohne dass reale Kits versendet werden. Den Zugang erhalten Sie im Rahmen des Onboardings – buchen Sie dafür eine Demo.

Die Probatix-API ist eine REST-Schnittstelle, die den kompletten Diagnostik-Workflow abdeckt: Testkits bestellen, Logistik- und Labor-Status über Webhooks verfolgen und Befunde als FHIR-R4-Bundle mit LOINC-codierten Werten empfangen. Eine Integration – von der Kit-Bestellung bis zum strukturierten Ergebnis.

REST FHIR R4 LOINC Webhooks <48h Time-to-Result

Demo buchen Ablauf einer Integration

Der Ablauf

Ablauf einer Integration

Vier Schritte, ein Datenfluss: Ihr System spricht ausschließlich mit der Probatix-API – Fulfillment, Labore und Befundlogik bleiben dahinter verborgen.

Bestellung anlegen

Ihr System legt per REST-Call einen Testauftrag an – mit Kit-Variante, Panel und Versandadresse. Probatix validiert die Pflichtangaben und startet das Fulfillment.

REST JSON

Logistik-Events empfangen

Versand, Zustellung, Probenrücksendung und Probeneingang im Labor: Jeder Statusübergang wird als Webhook an Ihr System gemeldet – ohne Polling.

Webhooks Tracking

Ergebnis-Webhook erhalten

Sobald der Befund ärztlich freigegeben ist, benachrichtigt ein Webhook Ihr System in Echtzeit. Sie entscheiden, wann und wie der Endnutzer informiert wird.

Echtzeit Event-basiert

Befund abrufen

Der Befund steht als strukturiertes JSON oder als FHIR-R4-Bundle bereit – DiagnosticReport und Observations, LOINC-codiert, mit Referenzbereichen.

FHIR R4 LOINC

FHIR R4

So sieht ein Befund aus

Gekürztes, generisches Beispiel eines FHIR-R4-Befunds: ein DiagnosticReport mit LOINC-codierter Observation inklusive Referenzbereich. Reale Befunde enthalten zusätzlich Specimen-Daten und alle Panel-Parameter.

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

Authentifizierung

Der API-Zugriff erfolgt über personalisierte Zugangsdaten, die Sie im Onboarding erhalten. Alle Endpunkte sind ausschließlich verschlüsselt über TLS erreichbar; Zugriffe sind mandantengetrennt und auditierbar protokolliert.

Dokumentation & Sandbox

Vollständige API-Referenz, Testumgebung und Beispielbefunde stellen wir Partnern im Onboarding bereit. Der schnellste Weg dorthin: ein Demo-Gespräch mit unserem Team.

Demo buchen und API-Zugang anfragen

Vertiefung im Wissenshub

Wie REST, FHIR-Befund und LOINC im Integrationsalltag zusammenspielen, zeigt der Wissen-Artikel Labordiagnostik per API integrieren – inklusive Workflow-Beispielen für Telemedizin und Health Apps. Für den Gesamtüberblick: die Probatix-Plattform und der DaaS-Leitfaden.

Häufige Fragen

Labordiagnostik-API: FAQ

Die vier Fragen, die Entwickler-Teams vor einer Integration am häufigsten stellen.

Welche FHIR-Version wird unterstützt?

Befunde werden als FHIR-R4-Bundle ausgeliefert – mit DiagnosticReport, Observation und Specimen als zentralen Ressourcen. Die Parameter sind LOINC-codiert, Einheiten folgen UCUM. Für Systeme ohne FHIR-Anbindung steht derselbe Befund als strukturiertes JSON zur Verfügung.

Gibt es Webhooks für Statusübergänge?

Ja. Alle relevanten Statusübergänge – von der Auftragsanlage über Versand und Probeneingang bis zur Befundfreigabe – lösen Webhooks aus. Ihr System bleibt in Echtzeit synchron, ohne die API periodisch abfragen zu müssen.

Wie schnell liegen Ergebnisse vor?

Für die meisten Tests liegt das Ergebnis innerhalb von 48 Stunden nach Probeneingang im Labor vor. Der Ergebnis-Webhook feuert unmittelbar nach der ärztlichen Freigabe des Befunds.

Gibt es eine Testumgebung?

Ja. Für die Integrationsphase stellen wir eine Testumgebung bereit, in der sich Bestellungen, Statusübergänge und Beispielbefunde durchspielen lassen, ohne dass reale Kits versendet werden. Den Zugang erhalten Sie im Rahmen des Onboardings – buchen Sie dafür eine Demo.

Eine API. Der komplette Diagnostik-Workflow.

Technisches Deep-Dive mit unserem Team: Architektur, Beispiel-Payloads und Sandbox-Zugang für Ihren Use-Case.

Demo buchen Zur White-Label-Übersicht