Ugrás a fő tartalomhoz
POST
Jelezd, hogy a páciens levette a mintáját. Ez a Vérvétel megerősítése otthoni tesztkészletes megfelelője — vonalkód nélkül, mert a készlet kódja csomagoláskor kerül rá. Csak a mintavétel időbélyegét adod át. Az időbélyeg klinikailag fontos: ez lesz a mintavétel ideje a laborleleten. A páciens tényleges mintavételi időpontját küldd el, ne azt a pillanatot, amikor a rendszered feldolgozta. Ugyanannak az activated_at értéknek az újraküldése 200 kódot ad vissza az aktivált rendeléssel; egy másik érték 409 kódot ad vissza. Lásd: Idempotencia. Az aktiválás activated állapotba lépteti a rendelést — ez végleges státusz. Az aktivált rendelés már nem mondható le, az összetétele és a szállítási címe pedig zárolva van. A rendszer elfogadja az aktiválást, amíg a rendelés pending vagy dispatched állapotú, feltéve, hogy van lab_code kódja — a páciensnél már lehet készlet azelőtt is, hogy a nyilvántartásunk feladottként jelölné, a valós mintavételi ideje pedig mindig felülírja a nyilvántartásunkat. A lab_code nélküli rendelés 409 kódot ad vissza: a kód nélkül a minta nem párosítható a pácienshez a laboratóriumban. Az aktiválás egyúttal leadja a laboratóriumi rendelést a készlet paneljére a rendelés lab_code kódja alatt, így a laboratórium számít a mintára, és az eredmények azonnal hozzárendelhetők, amint megérkeznek. Ez aszinkron módon, a válasz után történik — egy laboratóriumi probléma soha nem buktatja el a kérésedet. Innentől az Eredmények lekérése a markereket planned állapotban mutatja, amíg a laboratórium nem jelenti őket. A home_kit_order.results.updated webhook értesít, amikor változnak. Ha a minta azelőtt érkezik meg a laboratóriumba, hogy aktiválnád a készletet, az Aniva aktiválja. Az activated_at értéke a visszaküldött csomag első követési eseményének reggele, vagy ha nincs követés, annak a napnak a reggele, amikor a minta megérkezett a laboratóriumba. Egy későbbi, eltérő activated_at értékkel indított hívás ezután 409 kódot ad vissza. A home_kit_orders_manage scope vagy a szűkebb home_kit_orders_activate scope szükséges hozzá.

Kérés

Útvonalparaméterek

string
kötelező
Az aktiválandó otthoni tesztkészlet-rendelés egyedi azonosítója (UUID).

Törzsparaméterek

string
kötelező
A páciens mintavételének UTC időpontja (ISO 8601 Z utótaggal, pl. 2026-08-28T07:30:00Z). Nem lehet a jövőben, és nem lehet 30 napnál régebbi.

Válasz

Siker esetén az API 200 OK választ ad vissza a frissített otthoni tesztkészlet-rendeléssel — a status értéke activated, az activated_at pedig az általad küldött időbélyeget tartalmazza.

Hibaválaszok