Ugrás a fő tartalomhoz
GET
Kérj le egyetlen vérvételi időpontot UUID alapján, a beágyazott páciensprofillal együtt. Ezzel a végponttal ellenőrizheted az időpont állapotát, megerősítheted a foglalás részleteit, vagy lekérheted a hozzá tartozó profiladatokat. Az appointments_view vagy az appointments_schedule scope szükséges.

Kérés

Útvonalparaméterek

string
kötelező
A lekérendő időpont egyedi azonosítója (UUID).

Válasz

Siker esetén az API 200 OK választ ad vissza az időponttal és a beágyazott profiljával.
string
kötelező
Az időpont egyedi azonosítója (UUID).
string
kötelező
Annak a profilnak az UUID-ja, amelyhez ez az időpont tartozik.
string
Annak a vizsgálati helyszínnek az UUID-ja, ahol a vérvétel történik.
string
A lefoglalt időpont dátuma és ideje UTC időpontként (ISO 8601 Z végződéssel, pl. 2026-05-15T10:30:00Z). Lehet null.
string
kötelező
Az időpont aktuális állapota. A következő értékek egyike: pending, confirmed, blood_drawn vagy cancelled. A laboreredmények elkészültségének részleteit az Eredmények lekérése végpont adja meg; a szállítmány részletesebb előrehaladását pedig a beágyazott shipments tömb egyes elemein (lásd alább) keresztül a Szállítmány lekérése végponton követheted.
string
Az időpont lemondásakor rögzített szabadszöveges ok (pl. meg nem jelenés, késői lemondás, „Sikertelen. Ismétlés szükséges”). null, kivéve, ha a status értéke cancelled.
string[]
kötelező
Címek, amelyek mindegyike egy-egy e-mailt kap, amint minden laboreredmény végleges, kisbetűvel. Kikapcsolva üres. Lásd: Eredmények elkészültéről szóló e-mailek.
string
kötelező
A vérvétel módja: capillary (ujjbegyből vagy felkarból, mikrocsövekbe) vagy venous (vénából, csövekbe). Az időpontnál beállított módszer, ennek hiányában a helyszín default_draw_method értéke. A vérvétel után a ténylegesen használt módszer.
string
kötelező
Az időpont létrehozásának ISO 8601 időbélyege.
string
Az utolsó frissítés ISO 8601 időbélyege. Lehet null.
object
kötelező
Az időponthoz tartozó páciensprofil.
AppointmentPanel[]
kötelező
Az időponthoz jelenleg csatolt panelek. Nem tartalmazza a törölt csatolásokat. A panel részleteit (név, biomarkerek) a Panelek listázása végponton nézheted meg.
AppointmentIndividualBiomarker[]
kötelező
Panelen kívül az időponthoz csatolt egyedi biomarkerek (lásd: Egyedi biomarkerek hozzáadása). A megjelenítési adatokhoz vesd össze az egyes biomarker_id értékeket ezzel: Biomarkerek listázása.
AppointmentShipmentLink[]
kötelező
Az időponthoz kapcsolt küldemények, a legrégebbi kapcsolással kezdve. Üres tömb, ha nincs kapcsolt küldemény. Keresd ki az egyes id értékeket a Küldemény lekérése végponton a teljes küldeményadatokért (állapot, követési szám, állapotfrissítések stb.).
string[]
kötelező
Ehhez az időponthoz rögzített laborkódok (csővonalkódok), beolvasási sorrendben. A vérvétel megerősítéséig üres. A vénás vérvétel egyetlen kódot használ, amely minden csőre rá van nyomtatva; a kapilláris vérvétel mikrocsövenként egy kódot használ. Az Eredmények lekérése eredményei és dokumentumai a lab_code segítségével hivatkoznak ezekre a kódokra.

Ismételt hívások

Az Aniva 15 percig tárolja ennek a végpontnak a válaszát minden API-kulcshoz. Az ezen az időn belüli ismételt hívás a tárolt választ kapja vissza, amíg az időpont változatlan. Módosítás után friss választ kapsz. A Cache-Status és az Age fejléc mutatja, hogy a válasz tárolt, és milyen régi. Ha azonnal értesülni szeretnél a változásokról, iratkozz fel az appointment.created, az appointment.rescheduled és az egyes állapotok webhook-eseményeire, például az appointment.confirmed eseményre. Lásd: Ismételt olvasások.

Hibaválaszok