Grupuri de profiluri
Când creezi un profil, îl atribui unui grup de profiluri folosind parametrulprofile_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
UUID generat automat de Aniva. Folosește-l pentru a face referire la profil în alte apeluri API.
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.
Adresa de e-mail a pacientului. Dacă nu furnizezi una la creare, Aniva generează automat o adresă
de e-mail de înlocuire.
Număr de telefon în format E.164 (de ex.,
+14155552671). Poate
fi null.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.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.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ă.
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:- Creează — înregistrează profilul cu câmpurile demografice obligatorii și un
profile_group(UUID sau slug). - Actualizează (opțional) — adaugă sau modifică câmpuri precum
phone,heightsauweight. - Asociază — leagă profilul de programări folosind
id-ul său caprofile_id.
profile.* te anunță când apare, se modifică sau este șters un profil.