Ugrás a fő tartalomhoz
GET
Vérvételi időpontok listájának lekérése. Minden időpont tartalmazza a beágyazott páciensprofilt. A szűrők kombinálhatók:
  • A date egy adott naptári nap időpontjait adja vissza. A nap az egyes időpontok helyszínének helyi napja, így egy berlini 23:30-as vérvétel a berlini dátumhoz számít.
  • A location_id egy adott vizsgálati helyszín időpontjait adja vissza.
  • A profile_id date nélkül az adott profil összes időpontját visszaadja, időkorlátozás nélkül.
  • profile_id és date nélkül az alapértelmezett időablak érvényes: az elmúlt 2 hónaptól a következő 1 hónapig.
Az appointments_view vagy az appointments_schedule scope szükséges.

Kérés

Lekérdezési paraméterek

string
Szűrés profil-UUID alapján. Megadása esetén a profil összes időpontját visszaadja az ütemezés dátumától függetlenül. Ha elhagyod, az alapértelmezett időablak érvényes.
string
Szűrés a vizsgálati helyszín UUID-je alapján.
string
Naptári nap YYYY-MM-DD formátumban, az egyes időpontok helyszínének időzónájában. Felülírja az alapértelmezett időablakot. Az eredmények scheduled_at szerint rendeződnek, a legkorábbival elöl.

Válasz

Siker esetén az API 200 OK választ ad vissza időpontobjektumok tömbjével.
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 minden API-kulcshoz 5 percig tárolja ennek a végpontnak a válaszát. Ezen az időn belül egy ismételt hívás a tárolt választ kapja vissza. A Cache-Status és az Age fejléc mutatja, hogy a válasz tárolt, és mennyi idős. 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