Zum Hauptinhalt springen
Mit dieser Anleitung findest du einen Teststandort, erstellst einen Termin für ein Patientenprofil und fügst die gewünschten Test-Panels hinzu. Schließe diese Schritte ab, bevor der Patient zur Blutabnahme erscheint.
1

Verfügbare Standorte durchsuchen

Rufe die Liste der für dein Konto verfügbaren Teststandorte mit einer GET-Anfrage an /api/v1/locations ab.
Die Antwort ist ein Array aus Standortobjekten:
Nutze das Feld timezone aus dem Standortobjekt, wenn du deinen scheduled_at-Zeitstempel erstellst. Wenn du die Terminzeit in die lokale Zeitzone des Standorts umrechnest, vermeidest du Buchungen außerhalb der Öffnungszeiten.
Leite buchbare Zeiten nicht allein aus open_hours ab. Rufe Verfügbarkeit abrufen auf und buche eine dort zurückgegebene Startzeit – dieses Raster berücksichtigt auch bestehende Buchungen, Ausnahmen für einzelne Tage und die Mindestvorlaufzeit.
2

Termin erstellen

Sende eine POST-Anfrage an /api/v1/appointments mit der Profil-ID, der Standort-ID und deiner gewünschten Terminzeit. Die Zeit muss eine Startzeit aus Verfügbarkeit abrufen sein.
scheduled_at muss ein künftiger Zeitpunkt im ISO-8601-Format sein, zum Beispiel 2026-05-12T07:30:00Z. Zeitstempel in der Vergangenheit werden mit einem 400-Fehler abgelehnt, ebenso Zeiten innerhalb der 12-stündigen Mindestvorlaufzeit an von Aniva betriebenen Standorten.
Du kannst diese Anfrage sicher wiederholen. Ein Profil kann pro Standort und Uhrzeit nur einen Termin haben, daher gibt eine erneut oder doppelt gesendete Anfrage 409 mit der bestehenden appointment_id zurück, statt den Patienten doppelt zu buchen.
Eine erfolgreiche Anfrage gibt 201 Created mit dem Terminobjekt zurück:
Speichere die Termin-id – du brauchst sie, um Panels hinzuzufügen und die Blutabnahme zu bestätigen.
3

Test-Panels hinzufügen

Füge die Test-Panels hinzu, die für die Blutprobe durchgeführt werden sollen, indem du eine POST-Anfrage an /api/v1/appointments/{id}/panels sendest.Panel-IDs sind UUIDs. Rufe Panels auflisten auf, um die Panels abzurufen, die dein API-Key bestellen kann.
Nach der Bestätigung der Blutabnahme können keine Panels mehr hinzugefügt werden. Füge alle benötigten Panels vor der Bestätigung hinzu – Details findest du unter Blutabnahme bestätigen.
Eine erfolgreiche Anfrage gibt 200 OK zurück und bestätigt, dass die Panels hinzugefügt wurden:

Verschieben oder stornieren

Nach dem Erstellen kannst du einen Termin noch ändern, bevor die Blutabnahme bestätigt wird:
  • Verschieben oder Standort ändern – Sende eine PATCH-Anfrage an /api/v1/appointments/{id} mit den zu ändernden Feldern. Siehe Termin aktualisieren.
  • Stornieren – Sende eine DELETE-Anfrage an /api/v1/appointments/{id}. Siehe Termin stornieren.
Beide Vorgänge sind nur vor der Blutabnahme möglich – also solange der Termin den Status pending oder confirmed hat. Sobald der Termin auf blood_drawn wechselt, sind keine weiteren Änderungen mehr möglich.

Fehlerbehandlung