Ugrás a fő tartalomhoz
DELETE
Mondj le egy időpontot az állapotának cancelled értékre állításával. Csak olyan időpontok mondhatók le, amelyeknél a vérvételt még nem erősítették meg. Egy már cancelled állapotú időpont lemondása 200 válasszal tér vissza az adott időponttal, és nem ír semmit — nem rögzít második lemondást. A válasz az Idempotent-Replayed: true értéket tartalmazza, így megkülönböztetheted az ismétlést attól a hívástól, amely elvégezte a műveletet. Egy eltérő cancellation_reason értékkel érkező ismétlés helyette 409 válasszal tér vissza: a rögzített ok soha nem íródik felül. Lásd: Idempotencia.
A vérvétel megerősítése után az időpont már nem mondható le — ez 409 Conflict választ ad.
Az appointments_schedule vagy az appointments_manage scope szükséges hozzá.

Kérés

Útvonalparaméterek

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

Törzsparaméterek

A törzs opcionális — ok rögzítése nélküli lemondáshoz egyáltalán ne küldj törzset.
string
A lemondás szabadszöveges oka, legfeljebb 500 karakter (pl. Patient no-show). Az időpontnál tárolódik, és ennél, valamint a későbbi lekérdezéseknél cancellation_reason néven tér vissza.

Válasz

Siker esetén az API 200 OK választ ad a lemondott időponttal és a beágyazott profillal.
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 állapota. Sikeres lemondás után cancelled lesz.
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 a lemondás előtt csatolt panelek. A panel részleteit (név, biomarkerek) a Panelek listázása segítségével keresheted 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 a lemondás előtt kapcsolt szállítmányok. Minden id összevethető ezzel: Szállítmány lekérése.
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.

Hibaválaszok