Profilcsoportok
Amikor profilt hozol létre, aprofile_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
Az Aniva által automatikusan generált UUID. Ezzel hivatkozhatsz a profilra más API-hívásokban.
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.
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.
Telefonszám E.164 formátumban (pl.
+14155552671).
Lehet null.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.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ó.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.
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. Ígydate_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:- Létrehozás — regisztráld a profilt a kötelező demográfiai mezőkkel és egy
profile_groupértékkel (UUID vagy slug). - Frissítés (opcionális) — adj hozzá vagy módosíts mezőket, például a
phone,heightvagyweightmezőt. - Összekapcsolás — kapcsold össze a profilt időpontokkal úgy, hogy az
idértékét adod megprofile_id-ként.
profile.* webhook jelzi, ha egy profil létrejön, módosul vagy törlődik.