Salt la conținutul principal
GET
Obține o singură programare pentru recoltare de sânge după UUID, inclusiv profilul încorporat al pacientului. Folosește acest endpoint pentru a verifica statusul programării, a confirma detaliile programării sau a obține datele profilului asociat. Necesită permisiunea appointments_view sau appointments_schedule.

Cerere

Parametri de cale

string
obligatoriu
Identificatorul unic (UUID) al programării de obținut.

Răspuns

La succes, API-ul returnează 200 OK cu programarea și profilul ei încorporat.
string
obligatoriu
Identificatorul unic al programării (UUID).
string
obligatoriu
UUID-ul profilului căruia îi aparține această programare.
string
UUID-ul locației de testare unde are loc recoltarea de sânge.
string
Data și ora programării în format UTC (ISO 8601 cu sufixul Z, de ex. 2026-05-15T10:30:00Z). Poate fi null.
string
obligatoriu
Statusul curent al programării. Una dintre valorile pending, confirmed, blood_drawn sau cancelled. Detaliile privind finalizarea rezultatelor de laborator se obțin din Obține rezultatele; evoluția detaliată a expedierii se obține din fiecare intrare din lista inline shipments (vezi mai jos), urmată de Obține expedierea.
string
Motivul în text liber înregistrat la anularea programării (de ex. neprezentare, anulare tardivă, „Eșuat. Necesită repetare”). Este null dacă status nu este cancelled.
string[]
obligatoriu
Adresele care primesc fiecare câte un e-mail când toate rezultatele de laborator sunt finale, cu litere mici. Gol când este dezactivat. Vezi E-mailuri pentru rezultate gata.
string
obligatoriu
Cum se face recoltarea de sânge: capillary (din vârful degetului sau partea superioară a brațului, în microtainere) sau venous (din venă, în eprubete). Este metoda setată pe programare sau default_draw_method al locației acesteia. După recoltarea de sânge, este metoda care a fost folosită.
string
obligatoriu
Timestamp ISO 8601 al creării programării.
string
Timestamp ISO 8601 al ultimei actualizări. Poate fi null.
object
obligatoriu
Profilul pacientului asociat cu această programare.
AppointmentPanel[]
obligatoriu
Panelurile atașate în prezent acestei programări. Exclude atașările anulate. Consultă detaliile panelului (nume, biomarkeri) prin Listează panelurile.
AppointmentIndividualBiomarker[]
obligatoriu
Biomarkeri à la carte asociați cu această programare în afara unui panel (vezi Adaugă biomarkeri personalizați). Corelează fiecare biomarker_id cu Listează biomarkeri pentru datele de afișare.
AppointmentShipmentLink[]
obligatoriu
Expedierile asociate acestei programări, începând cu cea mai veche asociere. Array gol când nu există expedieri asociate. Verifică fiecare id prin Obține expedierea pentru datele complete ale expedierii (status, număr de urmărire, actualizări de status etc.).
string[]
obligatoriu
Codurile de laborator (codurile de bare de pe eprubete) înregistrate pentru această programare, în ordinea scanării. Gol până la confirmarea recoltării de sânge. O recoltare venoasă are un singur cod tipărit pe fiecare eprubetă; o recoltare capilară are câte un cod per microtainer. Rezultatele și documentele din Obține rezultate fac referire la aceste coduri prin lab_code.

Apeluri repetate

Aniva stochează răspunsul acestui endpoint timp de 15 minute pentru fiecare cheie API. Un apel repetat în acest interval primește răspunsul stocat atât timp cât programarea este neschimbată. După o modificare, primești un răspuns nou. Antetele Cache-Status și Age arată că răspunsul este stocat și cât de vechi este. Pentru a afla imediat despre o modificare, abonează-te la evenimentele webhook appointment.created, appointment.rescheduled și la evenimentul fiecărui status, de exemplu appointment.confirmed. Vezi Citiri repetate.

Răspunsuri de eroare