Salt la conținutul principal
Un profil este o înregistrare care reprezintă un pacient sau un utilizator în sistemul Aniva. Fiecare programare, comandă de laborator și rezultat se asociază cu un profil.

Grupuri de profiluri

Când creezi un profil, îl atribui unui grup de profiluri folosind parametrul profile_group. Un grup de profiluri organizează profilurile în contul tău de partener, asociindu-le unui anumit program sau unei anumite integrări. Câmpul profile_group acceptă fie UUID-ul imuabil al grupului, fie slug-ul său ușor de citit. UUID-ul este referința stabilă — nu se schimbă niciodată și rămâne valabil și după redenumirea slug-ului. Slug-ul este destinat URL-urilor ușor de citit și integrărilor cu partenerii. O valoare profile_group (UUID sau slug) este obligatorie la creare. Câmpul vechi profile_group_slug rămâne acceptat ca alias învechit.

Câmpuri

string
obligatoriu
UUID generat automat de Aniva. Folosește-l pentru a face referire la profil în alte apeluri API.
string
Un nume de utilizator sau handle opțional pentru profil. Poate fi null.
string
Prenumele pacientului. Doar caractere latine, 1–100 de caractere. Obligatoriu la creare.
string
Numele de familie al pacientului. Doar caractere latine, 1–100 de caractere. Obligatoriu la creare — laboratoarele resping comenzile pentru un pacient fără nume de familie. Poate fi null pentru profilurile create înainte să devină obligatoriu.
string
Adresa de e-mail a pacientului. Dacă nu furnizezi una la creare, Aniva generează automat o adresă de e-mail de înlocuire.
string
Număr de telefon în format E.164 (de ex., +14155552671). Poate fi null.
integer
Sexul biologic conform ISO/IEC 5218: 1 = masculin, 2 = feminin. Obligatoriu la creare, cu excepția cazului în care grupul tău de profiluri permite pacientului să îl introducă (vezi mai jos). Laboratorul are nevoie de el pentru intervalele de referință, deci o creare sau o actualizare cu 0 (necunoscut) returnează 400. Profilurile create înainte de 30 septembrie 2026 pot returna în continuare 0.
string
Data nașterii în format YYYY-MM-DD. Obligatorie la creare, cu excepția cazului în care grupul tău de profiluri permite pacientului să o introducă (vezi mai jos). Trebuie să fie în trecut, nu înainte de 1900, și să corespundă unei vârste între 16 și 100 de ani; valorile neverosimile sunt respinse cu 400. Data nașterii este trimisă la laborator pe comandă și nu poate fi modificată după plasarea comenzii.
number
Înălțimea în centimetri. Poate fi null.
number
Greutatea în kilograme. Poate fi null.
string
Limba preferată pentru comunicările către pacient. Valori acceptate: en, de, fi.
boolean
Indică dacă profilul primește e-mailuri tranzacționale, precum confirmările de programare și notificările când rezultatele sunt gata. Separat de acordul pentru marketing. Null dacă nu a fost setat niciodată.
string
obligatoriu
Marcaj temporal ISO 8601 al momentului în care a fost creat profilul.
string
Marcaj temporal ISO 8601 al celei mai recente actualizări. Null dacă profilul nu a fost actualizat niciodată.
Câmpurile first_name, last_name, sex, date_of_birth și profile_group sunt obligatorii la crearea unui profil. Toate celelalte câmpuri sunt opționale. Câmpul vechi profile_group_slug este încă acceptat ca alias învechit pentru profile_group.

Permite pacientului să introducă data nașterii și sexul

Putem activa o setare pentru grupul tău de profiluri. Astfel, poți crea un profil fără date_of_birth și sex. Cere-ne să o activăm. Fără ea, o creare care omite oricare dintre cele două câmpuri returnează 400. Pacientul le introduce pe ambele pe pagina de activare a kitului (anivahealth.com/activate), împreună cu codul kitului. Pagina cere data nașterii de două ori, deoarece laboratorul nu o poate modifica ulterior. După aceea, kitul se deschide doar cu acea dată a nașterii. Până când pacientul le introduce pe ambele, reținem comanda de laborator. Folosește această setare doar pentru kituri de testare la domiciliu.

Ciclul de viață

Profilurile urmează un ciclu de viață simplu:
  1. Creează — înregistrează profilul cu câmpurile demografice obligatorii și un profile_group (UUID sau slug).
  2. Actualizează (opțional) — adaugă sau modifică câmpuri precum phone, height sau weight.
  3. Asociază — leagă profilul de programări folosind id-ul său ca profile_id.
Un webhook profile.* te anunță când apare, se modifică sau este șters un profil.

Exemplu de profil