Zum Hauptinhalt springen
PATCH
Füge einer bestehenden Heimtest-Kit-Bestellung einen oder mehrere frei wählbare Biomarker hinzu, außerhalb eines vorgefertigten Panels. Dieser Endpunkt ist idempotent – bereits zugeordnete Biomarker bleiben erhalten. Erfordert den Scope home_kit_orders_manage sowie den Capability-Scope home_kit_orders_individual_biomarker_selection. Heimtest-Kits werden nach Panel bestellt, daher werden einzelne Marker pro Partner freigeschaltet. Frag bei Aniva nach, wenn deine Integration das braucht.
Biomarker können nur hinzugefügt werden, solange das Kit pending ist. Sobald das Kit dispatched ist, ist seine Zusammensetzung gesperrt und dieser Aufruf gibt 409 Conflict zurück – das physische Kit wird mit einer festen Anzahl an Röhrchen verschickt, die sich aus den ausgewählten Panels und Biomarkern ergibt, sodass sich der Inhalt nach dem Versand nicht mehr ändern lässt. Kits mit dem Status activated und cancelled sind ebenfalls gesperrt. Wenn du die Tests für ein gesperrtes Kit ändern musst, melde dich direkt bei Aniva – meistens ist das noch möglich, und wir nehmen die Änderung für dich vor, damit der Inhalt des Kits konsistent bleibt.

Anfrage

Pfadparameter

string
erforderlich
Eindeutige Kennung (UUID) der Heimtest-Kit-Bestellung, der Biomarker hinzugefügt werden sollen.

Body-Parameter

integer[]
erforderlich
Array von Biomarker-IDs, die der Heimtest-Kit-Bestellung hinzugefügt werden sollen. Muss mindestens ein Element enthalten. Nutze Biomarker auflisten mit home_kit=true, um Biomarker-IDs abzurufen.

Antwort

Bei Erfolg gibt die API 200 OK zurück und bestätigt, dass die Biomarker hinzugefügt wurden.
boolean
true, wenn die Biomarker erfolgreich zur Heimtest-Kit-Bestellung hinzugefügt wurden.

Fehlerantworten