Zum Hauptinhalt springen
Diese Anleitung führt dich durch den Kernablauf: einen Teststandort finden, ein Patientenprofil erstellen, einen Termin planen und eine Blutabnahme bestätigen.

Voraussetzungen

Du benötigst einen von Aniva ausgestellten Partner-API-Schlüssel.
Wenn du noch keinen API-Schlüssel hast, kontaktiere Aniva, um einen für dein Partnerkonto ausstellen zu lassen.

Schritte

1

Verfügbare Standorte auflisten

Rufe die Liste der Teststandorte ab, um eine location_id für den geplanten Termin zu finden.
Beispielantwort
Notiere dir die id des gewünschten Standorts. Du brauchst sie in Schritt 3.
2

Profil erstellen

Erstelle ein Patientenprofil, indem du die demografischen Daten übermittelst. Über profile_group wird das Profil mit deinem Partnerkonto verknüpft – hier wird entweder die unveränderliche UUID der Gruppe oder ihr lesbarer Slug akzeptiert.
Felder des Request-Bodys** Optional, wenn deine Profilgruppe dem Patienten erlaubt, beides auf der Kit-Aktivierungsseite einzugeben. Siehe Profile.Beispielantwort (201 Created)
Notiere dir die id aus der Antwort. Du verwendest sie im nächsten Schritt als profile_id.
3

Termin planen

Erstelle einen Termin mit der profile_id aus Schritt 2 und der location_id aus Schritt 1. Setze scheduled_at auf den Beginn eines Zeitfensters, das Verfügbarkeit abrufen für diesen Standort zurückgibt. Die API lehnt Zeiten ab, die nicht im Zeitraster liegen.
Beispielantwort (201 Created)
Notiere dir die id des Termins. Du brauchst sie, um die Blutabnahme zu bestätigen.
4

Blutabnahme bestätigen

Übermittle nach abgeschlossener Blutabnahme den Laborcode (Röhrchen-Barcode), um die Blutabnahme zu bestätigen und die Laborauftrags-Pipeline auszulösen. Bei einer Blutabnahme, deren Röhrchen mehrere Codes tragen, wird stattdessen lab_codes gesendet – siehe Blutabnahme bestätigen.
Beispielantwort (200 OK)
Nach der Bestätigung wird die Laborauftrags-Pipeline ausgelöst. Du kannst den Termin abrufen, um zu prüfen, ob sich der Status auf "blood_drawn" geändert hat.

Nächste Schritte