Salt la conținutul principal
GET
Preia o listă de programări pentru recoltare de sânge. Fiecare programare include profilul de pacient încorporat. Filtrele se combină:
  • date returnează programările dintr-o singură zi calendaristică. Ziua este ziua locală a locației fiecărei programări, așa că o recoltare de sânge la 23:30 în Berlin contează la data ei din Berlin.
  • location_id returnează programările de la o singură locație de testare.
  • profile_id fără date returnează toate programările pentru acel profil, fără restricție de timp.
  • Fără profile_id și fără date, se aplică intervalul de timp implicit: ultimele 2 luni până peste 1 lună.
Necesită permisiunea appointments_view sau appointments_schedule.

Cerere

Parametri de interogare

string
Filtrează după UUID-ul profilului. Când este furnizat, sunt returnate toate programările pentru acest profil, indiferent de data programării. Când lipsește, se aplică intervalul de timp implicit.
string
Filtrează după UUID-ul locației de testare.
string
Zi calendaristică în format YYYY-MM-DD, în fusul orar al locației fiecărei programări. Înlocuiește intervalul de timp implicit. Rezultatele sunt sortate după scheduled_at, cele mai devreme primele.

Răspuns

În caz de succes, API-ul returnează 200 OK cu un array de obiecte programare.
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 5 minute pentru fiecare cheie API. Un apel repetat în acest interval primește răspunsul stocat. 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