Zum Hauptinhalt springen
DELETE
Entferne einen oder mehrere Einzel-Biomarker aus einer bestehenden Heimtest-Kit-Bestellung. Das Entfernen ist idempotent: Nicht zugeordnete Biomarker werden ignoriert statt abgelehnt. Siehe Idempotenz. 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 entfernt werden, solange das Kit den Status pending hat. 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 sein Inhalt nach dem Versand nicht mehr ändern kann. Kits mit dem Status activated und cancelled sind ebenfalls gesperrt. Wenn du die Tests eines gesperrten Kits ändern musst, wende dich direkt an Aniva – das ist meistens 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, aus der Biomarker entfernt werden sollen.

Body-Parameter

integer[]
erforderlich
Array von Biomarker-IDs, die aus der Heimtest-Kit-Bestellung entfernt werden sollen. Muss mindestens einen Eintrag enthalten.

Antwort

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

Fehlerantworten