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 BeispielantwortNotiere dir die
location_id für den geplanten Termin zu finden.id des gewünschten Standorts. Du brauchst sie in Schritt 3.2
Profil erstellen
Erstelle ein Patientenprofil, indem du die demografischen Daten übermittelst. Über Felder des Request-BodysNotiere dir die
profile_group wird das Profil mit deinem Partnerkonto verknüpft – hier wird entweder die unveränderliche UUID der Gruppe oder ihr lesbarer Slug akzeptiert.** Optional, wenn deine Profilgruppe dem Patienten erlaubt, beides auf der Kit-Aktivierungsseite einzugeben. Siehe
Profile.Beispielantwort (201 Created)
id aus der Antwort. Du verwendest sie im nächsten Schritt als profile_id.3
Termin planen
Erstelle einen Termin mit der Beispielantwort (201 Created)Notiere dir die
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.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 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
lab_codes gesendet – siehe Blutabnahme bestätigen."blood_drawn" geändert hat.Nächste Schritte
- Füge Panels zu einem Termin hinzu, um festzulegen, welche Labortests durchgeführt werden sollen.
- Aktualisiere einen Termin, um ihn vor der Blutabnahme zu verschieben oder den Standort zu ändern.
- Storniere einen Termin, wenn er nicht mehr benötigt wird.
- Rufe Laborergebnisse ab, um klinische und genetische Ergebnisse nach der Verarbeitung zu erhalten.
- Lade Dokumente herunter, um Laborberichte als PDF abzurufen.
- Rufe ein Profil ab, um Patientendaten zu prüfen oder anzuzeigen.
- Sieh dir die vollständige API-Referenz für alle verfügbaren Endpunkte und Parameter an.