> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Profili

> Kā darbojas pacientu profili Aniva partneru API: izveido, atjaunini un sasaisti cilvēkus, kuriem piesaki asins analīzes un pasūti mājas testa komplektus.

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

**id** `string` *required*

Aniva automātiski ģenerēts UUID. Izmanto to, lai atsauktos uz profilu citos API pieprasījumos.

**handle** `string`

Neobligāts profila lietotājvārds vai segvārds. Var būt null.

**first\_name** `string`

Pacienta vārds. Tikai latīņu rakstzīmes, 1–100 rakstzīmes. Obligāts, veidojot profilu.

**last\_name** `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.

**email** `string`

Pacienta e-pasta adrese. Ja to nenorādi, veidojot profilu, Aniva automātiski ģenerē pagaidu
e-pasta adresi.

**phone** `string`

Tālruņa numurs [E.164 formātā](https://www.itu.int/rec/T-REC-E.164/en) (piem., `+14155552671`).
Var būt null.

**sex** `integer`

Bioloģiskais dzimums saskaņā ar [ISO/IEC 5218](https://www.iso.org/standard/36266.html): `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`.

**date\_of\_birth** `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.

**height** `number`

Augums centimetros. Var būt null.

**weight** `number`

Svars kilogramos. Var būt null.

**language** `string`

Vēlamā valoda saziņai ar pacientu. Pieņemtās vērtības: `en`, `de`, `fi`.

**transactional\_emails\_enabled** `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.

**created\_at** `string` *required*

ISO 8601 laikspiedols, kad profils tika izveidots.

**updated\_at** `string`

Pēdējās atjaunināšanas ISO 8601 laikspiedols. Null, ja profils nekad nav atjaunināts.

> [!NOTE]
>
> 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](https://docs.anivahealth.com/lv/concepts/webhooks.md) tev paziņo, kad profils parādās, mainās vai tiek dzēsts.

## Profila piemērs

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "handle": "jdoe42",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane.doe@example.com",
  "phone": "+14155552671",
  "sex": 2,
  "date_of_birth": "1990-06-15",
  "height": 168.0,
  "weight": 65.0,
  "language": "en",
  "transactional_emails_enabled": true,
  "created_at": "2026-03-01T09:00:00Z",
  "updated_at": "2026-03-10T14:32:00Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.