Hemostat Partner API
Aufträge programmatisch anlegen, den Chain-of-Custody-Verlauf abrufen und per Webhook über jeden Statuswechsel informiert werden.
Die Partner-API ist die REST-Schnittstelle der Hemostat-Plattform für Auftraggeber-Systeme (Klinik-, Apotheken- und Labor-Software). Sie deckt in Version 1 den Auftrags-Lebenszyklus ab: Aufträge anlegen, abfragen, stornieren, die manipulationssichere Ereignis-Historie lesen — und Webhooks für alle relevanten Statuswechsel.
Beta / kontrollierter Rollout: Der API-Zugang wird derzeit von Hemostat je Organisation freigeschaltet. Wenn Sie die Partner-API nutzen möchten, wenden Sie sich an Ihren Hemostat-Ansprechpartner oder über hemostat.de.
Auf einen Blick
| Basis-URL (Production) | https://my.hemostat.de/api/partner/v1 |
| Basis-URL (Sandbox) | https://qa.hemostat.de/api/partner/v1 |
| Authentifizierung | Authorization: Bearer <API-Key> |
| Format | JSON (Request und Response) |
| Versionierung | Major-Version in der URL (/v1), additiv innerhalb v1 |
| Spec | OpenAPI 3.1 zum Download |
Dokumentation
- Erste SchritteKey erhalten, Basis-URLs, der erste Call gegen /ping.
- AuthentifizierungBearer-Keys, hs_live_/hs_test_, Scopes, Widerruf.
- AufträgeAnlegen, Abfragen, Stornieren, Idempotenz, Event-Historie.
- Webhooks13 Events, HMAC-Signatur, Handshake, Retry-Verhalten.
- API-ReferenzAlle Endpoints interaktiv, mit Try-it und Code-Snippets.
- SandboxGefahrlos testen mit hs_test_-Keys auf der QA-Umgebung.
Warum die Event-Historie besonders ist
Jeder Schritt eines Transports (Abholung, Siegel-Scan, Transit,
Zustellung) wird bei Hemostat als SHA-256-hashverkettetes Ereignis
dokumentiert. Die Partner-API stellt diese Chain-of-Custody-Historie
je Auftrag über GET /orders/{id}/events
bereit — dieselbe Datenbasis, die auch das revisionssichere Protokoll
speist.