Ugrás a fő tartalomhoz
A profil egy pácienst vagy felhasználót leíró rekord az Aniva rendszerében. Minden időpont, laboratóriumi rendelés és eredmény egy profilhoz tartozik.

Profilcsoportok

Amikor profilt hozol létre, a profile_group paraméterrel hozzárendeled egy profilcsoporthoz. A profilcsoport a partnerfiókod alatt rendszerezi a profilokat, és egy adott programhoz vagy integrációhoz köti őket. A profile_group mező elfogadja a csoport megváltoztathatatlan UUID-jét vagy az ember által olvasható slugját is. Az UUID a tartós hivatkozás – soha nem változik, és a slug átnevezése után is érvényes marad. A slug az olvasható URL-ekhez és partnerintegrációkhoz való. Létrehozáskor kötelező megadni a profile_group értékét (UUID vagy slug). A régi profile_group_slug mező elavult aliasként továbbra is elfogadott.

Mezők

string
kötelező
Az Aniva által automatikusan generált UUID. Ezzel hivatkozhatsz a profilra más API-hívásokban.
string
A profil opcionális felhasználóneve vagy rövid azonosítója. Lehet null.
string
A páciens keresztneve. Csak latin karakterek, 1–100 karakter. Létrehozáskor kötelező.
string
A páciens vezetékneve. Csak latin karakterek, 1–100 karakter. Létrehozáskor kötelező – a laboratóriumok elutasítják a vezetéknév nélküli páciensek rendeléseit. A kötelezővé tétele előtt létrehozott profiloknál lehet null.
string
A páciens e-mail-címe. Ha létrehozáskor nem adsz meg egyet, az Aniva automatikusan generál egy helykitöltő e-mail-címet.
string
Telefonszám E.164 formátumban (pl. +14155552671). Lehet null.
integer
Biológiai nem az ISO/IEC 5218 szerint: 1 = férfi, 2 = nő. Létrehozáskor kötelező, hacsak a profilcsoportod nem engedi, hogy a páciens adja meg (lásd alább). A laboratóriumnak szüksége van rá a referenciatartományokhoz, ezért a 0 (ismeretlen) értékkel történő létrehozás vagy frissítés 400-at ad vissza. A 2026. szeptember 30. előtt létrehozott profilok továbbra is 0-t adhatnak vissza.
string
Születési dátum YYYY-MM-DD formátumban. Létrehozáskor kötelező, hacsak a profilcsoportod nem engedi meg a páciensnek, hogy maga adja meg (lásd alább). A múltban kell lennie, 1900-nál nem korábbinak, és 16 és 100 év közötti életkort kell jelentenie; a valószerűtlen értékeket a rendszer 400 hibakóddal elutasítja. A születési dátumot a rendeléssel együtt elküldjük a laboratóriumnak, és a rendelés leadása után már nem módosítható.
number
Magasság centiméterben. Lehet null.
number
Testsúly kilogrammban. Lehet null.
string
A páciensnek szóló kommunikáció előnyben részesített nyelve. Elfogadott értékek: en, de, fi.
boolean
Megadja, hogy a profil kap-e tranzakciós e-maileket, például időpont-visszaigazolásokat és az eredmények elkészültéről szóló értesítéseket. Független a marketing-hozzájárulástól. Ha soha nem állították be, az értéke null.
string
kötelező
A profil létrehozásának ISO 8601 időbélyege.
string
A legutóbbi frissítés ISO 8601 időbélyege. Null, ha a profilt még soha nem frissítették.
A first_name, last_name, sex, date_of_birth és profile_group mezők kötelezőek profil létrehozásakor. Minden más mező opcionális. A régi profile_group_slug mező továbbra is elfogadott a profile_group elavult aliasaként.

Hagyd, hogy a páciens adja meg a születési dátumát és a nemét

Bekapcsolhatunk egy beállítást a profilcsoportodhoz. Így date_of_birth és sex nélkül is létrehozhatsz profilt. Kérd tőlünk a bekapcsolását. Enélkül minden olyan létrehozás, amely bármelyik mezőt kihagyja, 400 hibakódot ad vissza. A páciens mindkettőt a tesztkészlet aktiválási oldalán (anivahealth.com/activate) adja meg, a tesztkészlet kódjával együtt. Az oldal kétszer kéri be a születési dátumot, mert a laboratórium később nem tudja módosítani. Ezután a tesztkészlet csak ezzel a születési dátummal nyitható meg. Amíg a páciens nem adja meg mindkettőt, visszatartjuk a laboratóriumi rendelést. Ezt a beállítást csak otthoni tesztkészleteknél használd.

Életciklus

A profilok egyszerű életciklust követnek:
  1. Létrehozás — regisztráld a profilt a kötelező demográfiai mezőkkel és egy profile_group értékkel (UUID vagy slug).
  2. Frissítés (opcionális) — adj hozzá vagy módosíts mezőket, például a phone, height vagy weight mezőt.
  3. Összekapcsolás — kapcsold össze a profilt időpontokkal úgy, hogy az id értékét adod meg profile_id-ként.
Egy profile.* webhook jelzi, ha egy profil létrejön, módosul vagy törlődik.

Példaprofil