Ugrás a fő tartalomhoz
PATCH
Frissítsd az időpont adatait, például a tervezett időt vagy a vizsgálati helyszínt. Csak azok az időpontok módosíthatók, amelyeknél a vérvételt még nem erősítették meg.
Az időpontok nem módosíthatók a vérvétel megerősítése után, illetve ha már lemondták őket. Ilyen időpont frissítési kísérlete 409 Conflict választ ad vissza. Az egyetlen kivétel a results_ready_emails, amelyet a vérvétel után is módosíthatsz.
Az appointments_schedule vagy az appointments_manage scope szükséges hozzá.

Kérés

Útvonalparaméterek

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

Törzsparaméterek

Minden törzsparaméter opcionális — csak azokat a mezőket add meg, amelyeket módosítani szeretnél.
string
Új időpont dátuma és ideje ISO 8601 formátumban (pl. 2026-05-20T14:00:00Z vagy 2026-05-20T16:00:00+02:00). Tartalmaznia kell időzóna-jelölőt — vagy Z-t, vagy explicit eltolást, például +02:00; az időzóna nélküli dátum-idő értékeket elutasítjuk. A jövőben kell lennie.Pontos, még szabad kapacitással rendelkező idősáv-kezdetnek kell lennie — lásd: Elérhetőség lekérdezése. Az átütemezett időpont soha nem számít bele a saját célidősávjának kapacitásába, de ha olyan idősávra helyezed át, ahol ugyanannak a profilnak már van egy másik időpontja, a kérés 409 kódot ad vissza annak az időpontnak az appointment_id értékével.Ha a célhelyszín Aniva üzemeltetésű, az új időnek legalább 12 órával későbbre kell esnie — lásd: Minimális előzetes idő.
string
Az új vizsgálati helyszín UUID-ja. A helyszínnek léteznie kell és aktívnak kell lennie. Az elérhető helyszínazonosítókat a Helyszínek listázása segítségével találod meg.
string[]
Lecseréli a legfeljebb 5 címből álló listát, amelynek minden tagja egy-egy e-mailt kap, amint minden laboreredmény véglegessé válik. Az e-mailek kikapcsolásához küldj [] értéket. Ez a mező a vérvétel után is szerkeszthető marad; csak a lemondott időpont utasítja el. A vérvétel után önmagában küldd el: ha ugyanabban a törzsben szerepel a scheduled_at vagy a location_id, a kérés 409 kódot ad vissza. A kulcsodnak results_view hozzáférésre van szüksége a pácienshez, különben 403 a válasz. Lásd: Eredményértesítő e-mailek.
string | null
Új vérvételi mód: capillary vagy venous, vagy null, ha újra a helyszín default_draw_method értékét szeretnéd használni. A helyszínnek tartalmaznia kell ezt a módot a draw_methods listájában, és a lefoglalt vizsgálatoknak elvégezhetőnek kell lenniük vele, különben 400 a válasz. Ha egy időpontot másik helyszínre helyezel át, ott ugyanez az ellenőrzés fut le: a saját draw_method értékén, vagy annak hiányában az új helyszín default_draw_method értékén.

Válasz

Siker esetén az API 200 OK választ ad vissza a frissített 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 tervezett időpont dátuma és ideje UTC időpillanatként (ISO 8601 Z végződéssel, pl. 2026-05-20T14:00: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 elöl. Üres tömb, ha nincs kapcsolt küldemény. A teljes küldeményadatokhoz egyeztesd az egyes id értékeket a Küldemény lekérdezése használatával.
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