Pāriet uz galveno saturu
Profils ir ieraksts, kas apzīmē pacientu vai lietotāju Aniva sistēmā. Katrs pieraksts, laboratorijas pasūtījums un rezultāts ir saistīts ar profilu.

Profilu grupas

Veidojot profilu, tu piešķir to profilu grupai, izmantojot parametru profile_group. Profilu grupa sakārto profilus tavā partnera kontā, piesaistot tos konkrētai programmai vai integrācijai. Lauks profile_group pieņem vai nu grupas nemainīgo UUID, vai cilvēkam lasāmu slug. UUID ir noturīga atsauce — tas nekad nemainās un saglabājas arī pēc slug pārdēvēšanas. Slug ir paredzēts lasāmiem URL un partneru integrācijām. Veidojot profilu, ir nepieciešama profile_group vērtība (UUID vai slug). Mantotais lauks profile_group_slug joprojām tiek pieņemts kā novecojis aizstājvārds.

Lauki

string
obligāts
Aniva automātiski ģenerēts UUID. Izmanto to, lai atsauktos uz profilu citos API pieprasījumos.
string
Neobligāts profila lietotājvārds vai segvārds. Var būt null.
string
Pacienta vārds. Tikai latīņu rakstzīmes, 1–100 rakstzīmes. Obligāts, veidojot profilu.
string
Pacienta uzvārds. Tikai latīņu rakstzīmes, 1–100 rakstzīmes. Obligāts, veidojot profilu — laboratorijas noraida pasūtījumus pacientam bez uzvārda. Var būt null profiliem, kas izveidoti, pirms tas kļuva obligāts.
string
Pacienta e-pasta adrese. Ja to nenorādi, veidojot profilu, Aniva automātiski ģenerē pagaidu e-pasta adresi.
string
Tālruņa numurs E.164 formātā (piem., +14155552671). Var būt null.
integer
Bioloģiskais dzimums saskaņā ar ISO/IEC 5218: 1 = vīrietis, 2 = sieviete. Obligāts, veidojot profilu, ja vien tava profilu grupa neļauj to ievadīt pacientam (skat. zemāk). Tas nepieciešams laboratorijai references intervāliem, tāpēc izveide vai atjaunināšana ar 0 (nezināms) atgriež 400. Profili, kas izveidoti pirms 2026. gada 30. septembra, joprojām var atgriezt 0.
string
Dzimšanas datums YYYY-MM-DD formātā. Obligāts, veidojot profilu, ja vien tava profilu grupa neļauj to ievadīt pacientam (skat. zemāk). Tam jābūt pagātnē, ne agrāk par 1900. gadu, un jāatbilst vecumam no 16 līdz 100 gadiem; neticamas vērtības tiek noraidītas ar 400. Dzimšanas datums tiek nosūtīts laboratorijai kopā ar pasūtījumu, un pēc pasūtījuma veikšanas to vairs nevar labot.
number
Augums centimetros. Var būt null.
number
Svars kilogramos. Var būt null.
string
Vēlamā valoda saziņai ar pacientu. Pieņemtās vērtības: en, de, fi.
boolean
Norāda, vai profils saņem transakciju e-pastus, piemēram, pieraksta apstiprinājumus un paziņojumus par gataviem rezultātiem. Atsevišķi no mārketinga piekrišanas. Null, ja nekad nav iestatīts.
string
obligāts
ISO 8601 laikspiedols, kad profils tika izveidots.
string
Pēdējās atjaunināšanas ISO 8601 laikspiedols. Null, ja profils nekad nav atjaunināts.
Veidojot profilu, ir obligāti lauki first_name, last_name, sex, date_of_birth un profile_group. Visi pārējie lauki nav obligāti. Mantotais lauks profile_group_slug joprojām tiek pieņemts kā novecojis profile_group aizstājvārds.

Ļaut pacientam ievadīt dzimšanas datumu un dzimumu

Mēs varam ieslēgt vienu iestatījumu tavai profilu grupai. Tad varēsi izveidot profilu bez date_of_birth un sex. Palūdz mums to ieslēgt. Bez tā profila izveide, izlaižot kādu no šiem laukiem, atgriež 400. Pacients abus ievada komplekta aktivizēšanas lapā (anivahealth.com/activate) kopā ar komplekta kodu. Lapa prasa dzimšanas datumu divreiz, jo laboratorija to vēlāk nevar labot. Pēc tam komplektu var atvērt tikai ar šo dzimšanas datumu. Kamēr pacients nav ievadījis abus, mēs aizturam laboratorijas pasūtījumu. Izmanto šo iestatījumu tikai mājas testa komplektiem.

Dzīves cikls

Profiliem ir vienkāršs dzīves cikls:
  1. Izveidot — reģistrē profilu ar obligātajiem demogrāfiskajiem laukiem un profile_group (UUID vai slug).
  2. Atjaunināt (neobligāti) — pievieno vai maini tādus laukus kā phone, height vai weight.
  3. Saistīt — sasaisti profilu ar pierakstiem, izmantojot tā id kā profile_id.
profile.* webhook tev paziņo, kad profils parādās, mainās vai tiek dzēsts.

Profila piemērs