Zum Hauptinhalt springen
POST
Füge einem bestehenden Termin ein oder mehrere Bluttest-Panels hinzu. Du kannst diesen Endpunkt mehrmals aufrufen, um die Panel-Auswahl vor dem Bestätigen der Blutabnahme zusammenzustellen. Erfordert den Scope appointments_schedule.
Nachdem du Blutabnahme bestätigen aufgerufen hast, können keine Panels mehr hinzugefügt werden. Der Versuch, einem bestätigten Termin Panels hinzuzufügen, gibt 409 Conflict zurück.
Bei einer kapillaren Blutabnahme (draw_method: capillary) wird die Blutabnahme auf Microtainer aufgeteilt. Panels kommen zuerst, in Buchungsreihenfolge. Einzelne Biomarker füllen dann den freien Platz in den Panel-Microtainern. Wenn sie mehr Platz brauchen, öffnen sie neue Microtainer. Wir verteilen sie gleichmäßig. Jeder Microtainer fasst höchstens 150 µl an einzelnen Biomarkern. Verstößt die resultierende Auswahl an Panels gegen diese Regel, gibt der Aufruf 400 mit einer error-Meldung zurück und es wird kein Panel hinzugefügt.

Anfrage

Pfadparameter

string
erforderlich
Eindeutige Kennung (UUID) des Termins, dem Panels hinzugefügt werden sollen.

Body-Parameter

string[]
erforderlich
Array mit Panel-UUIDs, die dem Termin hinzugefügt werden sollen. Muss mindestens ein Element enthalten.

Antwort

Bei Erfolg gibt die API 200 OK zurück und bestätigt, dass die Panels hinzugefügt wurden.
boolean
true, wenn die Panels erfolgreich zum Termin hinzugefügt wurden.

Fehlerantworten

Heimtest-Kit-Panel

Ein Heimtest-Kit wird an den Patienten gesendet und nicht bei einem Termin abgenommen. Ist ein Panel in panel_ids ein Heimtest-Kit, gibt der Aufruf 409 zurück und fügt kein Panel hinzu. Der Body hat diese Felder:
string
Für Menschen lesbarer Grund.
string
Immer home_kit_appointment_mismatch_error.
string
Der Termin, dem das Panel nicht hinzugefügt wurde.
string
Das Heimtest-Kit-Panel.
string | null
Der Heimtest-Kit-Anbieter des Panels oder null, wenn er nicht bekannt ist.