Přejít na hlavní obsah
GET
Načti jednu objednávku domácí testovací sady podle jejího UUID včetně vloženého profilu pacienta. Tento endpoint použij ke kontrole stavu objednávky, ověření doručovací adresy nebo zobrazení přiřazených panelů a biomarkerů. Vyžaduje rozsah home_kit_orders_view nebo home_kit_orders_manage.

Požadavek

Parametry cesty

string
povinné
Jedinečný identifikátor (UUID) objednávky domácí testovací sady, kterou chceš načíst.

Odpověď

Při úspěchu API vrátí 200 OK s objednávkou domácí testovací sady a jejím vloženým profilem.
string
povinné
Jedinečný identifikátor objednávky domácí testovací sady (UUID).
string
povinné
UUID profilu, ke kterému tato objednávka domácí testovací sady patří.
string
povinné
Aktuální stav objednávky domácí testovací sady. Jedna z hodnot pending, dispatched, activated nebo cancelled. Podrobný stav dokončení laboratorních výsledků zjistíš přes Získat výsledky.
object
povinné
Adresa pro doručení sady — jedna ze dvou podob: buď { location_id } s odkazem na známé testovací místo, nebo přímo vložená pole adresy (name, street, city, postal_code, country_code; nepovinně company_name / house_number / address_line_2 / state / phone / email — stejný slovník jako v locations API). Uveď přesně jednu variantu — odkaz na místo, nebo přímou adresu, ne obojí.
string
Laboratorní kód vzorku, pod kterým se hlásí výsledky — je vytištěný na fyzické sadě a pacient ho přečte z krabičky jako aktivační kód. null, dokud není sada zabalená. Pouze pro čtení.
string
povinné
Časové razítko odběru nahlášené přes Aktivace — kdy pacient odebral vzorek. null, dokud sada není aktivovaná.
string
Objednávka domácí testovací sady, kterou tato nahrazuje, pokud jde o náhradní sadu. null u běžné objednávky. Viz Vytvoření objednávky domácí testovací sady.
string
Důvod odeslání náhradní sady. null u běžné objednávky.
string[]
povinné
Adresy malými písmeny, z nichž každá dostane jeden e-mail, jakmile jsou všechny laboratorní výsledky konečné. Prázdné, když je vypnuto. Viz E-maily o připravených výsledcích.
object
povinné
Páry klíč/hodnota definované partnerem, vrácené beze změny. Vždy přítomné — {}, pokud nejsou nastaveny.
string
povinné
Časové razítko ve formátu ISO 8601, kdy byla objednávka domácí testovací sady vytvořena.
string
Časové razítko ISO 8601 poslední aktualizace. Může být null.
object
povinné
Profil pacienta spojený s touto objednávkou domácí testovací sady.
HomeKitOrderPanel[]
povinné
Panel přiřazený k této objednávce domácí testovací sady — vždy přesně jeden (domácí testovací sada odpovídá 1:1 fyzickému produktu sady), vyměnitelný přes Upravit, dokud je ve stavu pending. Podrobnosti o panelu (název, biomarkery) najdeš přes Seznam panelů.
HomeKitOrderIndividualBiomarker[]
povinné
Samostatné biomarkery přiřazené k této objednávce domácí testovací sady mimo jakýkoli panel. Každé biomarker_id si pro údaje k zobrazení dohledej přes Seznam biomarkerů s home_kit=true.
HomeKitOrderShipmentLink[]
povinné
Zásilky propojené s touto objednávkou domácí testovací sady, od nejstaršího propojení — obvykle sada k pacientovi a vzorek zpět do laboratoře. Prázdné, dokud expedice nevytiskne štítek. Úplné údaje o zásilkách načti přes Seznam zásilek s ?home_kit_order_id=.

Opakovaná volání

Aniva ukládá odpověď tohoto endpointu pro každý API klíč na 60 minut. Opakované volání během této doby dostane uloženou odpověď, dokud se objednávka domácí testovací sady nezmění. Po změně dostaneš čerstvou odpověď. Hlavičky Cache-Status a Age ukazují, že je odpověď uložená a jak je stará. Pokud se chceš o změně dozvědět hned, přihlas se k odběru webhook událostí home_kit_order.created a událostí pro jednotlivé stavy, například home_kit_order.activated. Viz Opakované čtení.

Chybové odpovědi