Ugrás a fő tartalomhoz
POST
Foglalj vérvételi időpontot egy páciensprofilnak egy adott vizsgálati helyszínen. Létrehozás után az időpont alapértelmezés szerint confirmed állapotba kerül (egyes helyszíneken ehelyett a pending lehet az alapértelmezett — ez helyszínenkénti beállítás). Használd a Panelek hozzáadása végpontot vérvizsgálati panelek csatolásához a vérvétel megerősítése előtt.
Egy profilnak helyszínenként és idősávonként legfeljebb egy időpontja lehet. Ha olyan idősávra hozol létre időpontot, amelyet a profil már lefoglalt, második időpont helyett 409-es válasz érkezik a meglévő appointment_id értékkel — így egy újrapróbált vagy véletlenül megismételt kérés soha nem duplikálja a foglalást. Lásd: Duplikált időpontok.
Küldj opcionális Idempotency-Key fejlécet, hogy a létrehozás biztonságosan újrapróbálható legyen — ugyanazzal a kulccsal megismételve az eredeti válasz érkezik vissza egy újabb létrehozása helyett. Lásd: Idempotencia. Az appointments_schedule jogosultsági kör szükséges hozzá.

Kérés

Törzsparaméterek

string
kötelező
Annak a páciensprofilnak az UUID-je, amelyhez az időpontot létrehozod.
string
kötelező
Annak a vizsgálati helyszínnek az UUID-je, ahol a vérvétel történik. A Helyszínek listázása végponttal keresheted meg az elérhető helyszínazonosítókat.
string
kötelező
Az időpont dátuma és ideje ISO 8601 formátumban (pl. 2026-05-15T10:30:00Z vagy 2026-05-15T12:30:00+02:00). Tartalmaznia kell időzóna-jelölőt — Z-t vagy explicit eltolást, például +02:00 értéket; az időzóna nélküli dátum-idő értékeket a rendszer elutasítja. Jövőbeli időpontnak kell lennie.A helyszín időbeosztása szerinti pontos idősávkezdetnek kell lennie, és az idősávban még kell lennie szabad helynek — először nézd meg az Elérhetőség lekérése végpontot. A beosztáson kívüli időpontok 400-at adnak vissza; a betelt idősáv 409-et ad vissza. Az Aniva által üzemeltetett helyszíneken legalább 12 órával későbbinek kell lennie — lásd: Minimális előfoglalási idő.
string[]
Legfeljebb 5 cím, amelyek mindegyike egy e-mailt kap, amint minden laboreredmény végleges. Az e-mail az Aniva adminfelületének eredményoldalára mutat. A kulcsodnak results_view hozzáférésre van szüksége a pácienshez, különben 403-at kapsz. Hagyd el, ha a páciens csoportjához beállított alapértelmezett címeket szeretnéd használni. Üres listával kikapcsolhatod az e-maileket. Lásd: Elkészült eredményekről szóló e-mailek.
string
A vérvétel módja: capillary vagy venous. Hagyd el, ha a helyszín default_draw_method értékét szeretnéd használni. A módszernek szerepelnie kell a helyszín draw_methods listájában, különben 400-at kapsz.

Válasz

Siker esetén az API 201 Created választ ad vissza az új időponttal.
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.
object
kötelező
Az időponthoz tartozó páciensprofil.
AppointmentPanel[]
kötelező
Az időponthoz jelenleg csatolt panelek. Újonnan létrehozott időpontoknál üres — a Panelek hozzáadása végponttal csatolhatod őket. A panelek részleteit (név, biomarkerek) a Panelek listázása végponton keresheted meg.
AppointmentIndividualBiomarker[]
kötelező
Az időponthoz panelen kívül csatolt, külön választható biomarkerek. Újonnan létrehozott időpontoknál üres — az Egyedi biomarkerek hozzáadása végponttal csatolhatod őket. A megjelenítési adatokhoz vesd össze az egyes biomarker_id értékeket a Biomarkerek listázása végponttal.
AppointmentShipmentLink[]
kötelező
Az időponthoz kapcsolt szállítmányok, a legrégebben kapcsolttal kezdve. Újonnan létrehozott időpontoknál üres — a Szállítmány létrehozása (az appointment_id megadásával) vagy az Időpontok csatolása szállítmányhoz végponttal kapcsolhatod össze őket.
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.

Minimális előfoglalási idő

Az Aniva által üzemeltetett helyszíneken az időpontokat legalább 12 órával előre kell foglalni; ezen az időablakon belüli foglalás 400-at ad vissza. Az Elérhetőség lekérése végpont már eleve visszatartja ezeket az idősávokat, így minden foglalható, ami abban a beosztásban megjelenik. A saját üzemeltetésű helyszíneiden nincs minimális előfoglalási idő — az aznapi és a helyszíni foglalás változatlan marad.

Duplikált időpontok

Egy profilnak helyszínenként és időpillanatonként legfeljebb egy nem lemondott időpontja lehet — egy személynél nem lehet kétszer vérvételt végezni ugyanazon a helyen és ugyanabban a pillanatban, bármennyi szék is van a helyszínen. Ha olyan idősávra hozol létre időpontot, amelyet a profil már elfoglalt, 409-es válasz érkezik egy appointment_id mezővel, amely a már meglévő időpontot azonosítja:
Kezeld úgy, mintha a kérés már teljesült volna: kérd le az időpontot az Időpont lekérése végponttal, helyezd át az Időpont módosítása végponttal, vagy mondd le az Időpont lemondása végponttal. Ne próbáld újra a létrehozást — továbbra is 409-et fog visszaadni. Így az ismételt létrehozások biztonságosak: egy időtúllépés után újraküldött kérés vagy egy kétszer beküldött űrlap nem hozhat létre két időpontot ugyanannak a páciensnek ugyanabban az időben.
Az appointment_id csak a duplikáció miatti 409-es válaszban szerepel. A kapacitás miatti 409 — amikor az idősáv azért telt be, mert más páciensek foglalták el — csak error mezőt ad vissza, és ilyenkor az a helyes megoldás, ha egy másik idősávot választasz az Elérhetőség lekérése végpontból.

Hibaválaszok