Salt la conținutul principal
Folosește acest ghid pentru a găsi o locație de testare, a crea o programare pentru un profil de pacient și a atașa panelurile de analize care trebuie efectuate. Parcurge acești pași înainte ca pacientul să ajungă la recoltarea de sânge.
1

Consultă locațiile disponibile

Obține lista locațiilor de testare disponibile în contul tău trimițând o cerere GET către /api/v1/locations.
Răspunsul este un array de obiecte de locație:
Folosește câmpul timezone din obiectul locației atunci când construiești timestamp-ul scheduled_at. Convertirea orei programării la fusul orar local al locației te ajută să eviți programările în afara orelor de funcționare.
Nu deduce orele disponibile doar din open_hours. Apelează Obține disponibilitatea și rezervă o oră de început returnată de acesta — acea grilă ține cont și de programările existente, excepțiile pe anumite date și preavizul minim.
2

Creează programarea

Trimite o cerere POST către /api/v1/appointments cu ID-ul profilului, ID-ul locației și ora dorită pentru programare. Ora trebuie să fie o oră de început a unui interval din Obține disponibilitatea.
scheduled_at trebuie să fie o dată și o oră din viitor în format ISO 8601, de exemplu 2026-05-12T07:30:00Z. Timestamp-urile din trecut sunt respinse cu o eroare 400, la fel și orele care intră în preavizul minim de 12 ore în locațiile operate de Aniva.
Repetarea acestei cereri este sigură. Un profil poate avea o singură programare pentru o anumită locație și oră, așa că o cerere de creare retrimisă sau duplicată returnează 409 cu appointment_id existent, în loc să programeze pacientul de două ori.
O cerere reușită returnează 201 Created împreună cu obiectul programării:
Salvează id-ul programării — vei avea nevoie de el pentru a adăuga paneluri și a confirma recoltarea de sânge.
3

Adaugă paneluri de analize

Atașează panelurile de analize pe care vrei să le efectuezi pe proba de sânge trimițând o cerere POST către /api/v1/appointments/{id}/panels.ID-urile panelurilor sunt UUID-uri. Apelează Listează panelurile pentru a obține panelurile pe care cheia ta API le poate comanda.
Panelurile nu mai pot fi adăugate după confirmarea recoltării de sânge. Adaugă toate panelurile necesare înainte de confirmare — consultă Confirmă recoltarea de sânge pentru detalii.
O cerere reușită returnează 200 OK, confirmând că panelurile au fost adăugate:

Reprogramare sau anulare

După ce creezi o programare, o mai poți modifica înainte de confirmarea recoltării de sânge:
  • Reprogramează sau schimbă locația — Trimite o cerere PATCH către /api/v1/appointments/{id} cu câmpurile de actualizat. Consultă Actualizează programarea.
  • Anulează — Trimite o cerere DELETE către /api/v1/appointments/{id}. Consultă Anulează programarea.
Ambele operațiuni sunt disponibile doar înainte de recoltarea de sânge — adică cât timp programarea are statusul pending sau confirmed. Odată ce programarea trece în blood_drawn, nu mai sunt posibile modificări.

Gestionarea erorilor