> ## 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.

# Izveidot profilu

> Izveidot jaunu pacienta profilu un piesaistīt to profilu grupai

Izveido jaunu pacienta profilu un piešķir to profilu grupai. Profilā glabājas demogrāfiskie dati, ko izmanto pierakstos un laboratorijas pasūtījumos.

Nepieciešams `create_user` tvērums.

Nosūti neobligātu `Idempotency-Key` galveni, lai šo izveides pieprasījumu varētu droši atkārtot — atkārtojot to pašu atslēgu, tiek atgriezta sākotnējā atbilde, nevis izveidots otrs pieraksts. Skati [Idempotence](https://docs.anivahealth.com/lv/concepts/idempotency.md).

## Pieprasījums

### Pieprasījuma satura parametri

**first\_name** `string` *required*

Pacienta vārds. Jāizmanto latīņu alfabēta rakstzīmes, no 1 līdz 100 rakstzīmēm.

**last\_name** `string` *required*

Pacienta uzvārds. Jāizmanto latīņu alfabēta rakstzīmes, no 1 līdz 100 rakstzīmēm. Laboratorijas noraida
pasūtījumus pacientam bez uzvārda, tāpēc profilu bez tā nevar izveidot.

Trīs vērtības ir rezervētas testa datu izveidei — skati [Sandbox testa dati](#sandbox-testa-dati).

**sex** `integer` *required*

Bioloģiskais dzimums atbilstoši ISO/IEC 5218. Izmanto `1` vīrietim, `2` sievietei. Tas laboratorijai ir nepieciešams
references intervāliem, tāpēc `0` (nezināms) atgriež `400`. Obligāts, ja vien tava profilu grupa neļauj
pacientam to ievadīt komplekta aktivizēšanas lapā. Tad to izlaid. Skati
[Ļaut pacientam ievadīt dzimšanas datumu un dzimumu](https://docs.anivahealth.com/lv/concepts/profiles.md#laut-pacientam-ievadit-dzimsanas-datumu-un-dzimumu).

**date\_of\_birth** `string` *required*

Dzimšanas datums formātā `YYYY-MM-DD`. Jābūt pagātnē un ne agrāk par 1900. gadu. Aprēķinātajam vecumam
jābūt no 16 līdz 100 gadiem. Citas vērtības atgriež `400`. Obligāts, ja vien tava profilu grupa neļauj
pacientam to ievadīt komplekta aktivizēšanas lapā. Tad to izlaid.

**profile\_group** `string` *required*

Polimorfa atsauce (UUID vai slug) uz profilu grupu, kurai piešķirt šo profilu. UUID ir
nemainīgs identifikators un saglabājas arī pēc slug pārdēvēšanas; slug joprojām tiek pieņemts mārketinga un
partneru integrācijām, kas balstītas uz salasāmiem identifikatoriem. Ieteicams izmantot UUID. Profilu grupai ir jābūt
tavas API atslēgas piekļuves kontekstā. Obligāts, ja vien nenosūti novecojušo
`profile_group_slug`.

**profile\_group\_slug** `string` *deprecated*

Novecojis: izmanto `profile_group`. Profilu grupas slug. Tikai mazie burti, cipari, defises un
pasvītras.

**email** `string`

Profila e-pasta adrese. Ja to izlaid, Aniva automātiski izveido e-pasta adresi.

Norādot `email`, izveide kļūst **droša pret atkārtotiem mēģinājumiem**: vienai adresei var būt tikai viens profils, tāpēc
atkārtots pieprasījums atgriež `409`, nevis izveido otru profilu. Automātiski izveidotās adreses ir unikālas katram
pieprasījumam. Nosūti `email` vai `Idempotency-Key`, ja tava integrācija atkārto pieprasījumus.

**phone** `string`

Tālruņa numurs E.164 formātā (piemēram, `+14155552671`).

**height** `number`

Augums centimetros.

**weight** `number`

Svars kilogramos.

**language** `string` (default: en)

Vēlamā profila valoda: `en`, `bg`, `ca`, `cs`, `da`, `de`, `el`, `es`, `et`, `fi`, `fr`, `ga`, `hr`, `hu`, `is`, `it`, `lb`, `lt`, `lv`, `mt`, `nl`, `no`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `tr` vai `uk`. Noklusējuma vērtība ir `en`.

**transactional\_emails\_enabled** `boolean`

Vai šim profilam jāsaņem transakciju (automātiskie) e-pasti — pierakstu
apstiprinājumi, paziņojumi par gataviem rezultātiem u. c. Pārraksta profilu grupas noklusējumu. Nav saistīts ar
piekrišanu mārketingam. Izlaid, lai izmantotu noklusējumu.

**marketing\_emails\_enabled** `boolean`

Vai šis profils piekrīt saņemt mārketinga e-pastus (jaunumus, produktu atjauninājumus). Pārraksta
profilu grupas noklusējumu. Nav saistīts ar transakciju e-pastiem. Izlaid, lai izmantotu profilu grupas noklusējumu.
Tikai rakstīšanai: netiek atgriezts profila atbildē.

## Sandbox testa dati

Katrs testēšanas vērts lasīšanas ceļš — [Iegūt pierakstu sarakstu](https://docs.anivahealth.com/lv/api/appointments/list-appointments.md),
[Iegūt rezultātus](https://docs.anivahealth.com/lv/api/appointments/get-results.md),
[Lejupielādēt dokumentu](https://docs.anivahealth.com/lv/api/documents/download-document.md) — ir tukšs, līdz dažas dienas vēlāk notiek reāla asins paņemšana.
Tāpēc automātisku integrācijas testu ir neērti uzrakstīt.

Lai to atrisinātu, ir rezervētas trīs `last_name` vērtības. Izveido profilu ar vienu no tām, un Aniva
pirms atbildes nosūtīšanas sagatavos tālāk aprakstīto stāvokli, lai tavs nākamais pieprasījums to jau redzētu:

| `last_name` | Ko profils saņem |
| - | - |
| `Upcomingtestmann` | Viens gaidāms `confirmed` pieraksts ar pievienotu paneli. Rezultātu vēl nav. |
| `Partialtestmann` | Viens pagājis `blood_drawn` pieraksts. Ir rezultāti aptuveni **pusei** paneļa; [Iegūt rezultātus](https://docs.anivahealth.com/lv/api/appointments/get-results.md) ir `in_progress`. |
| `Fulltestmann` | Viens pagājis `blood_drawn` pieraksts. Ir rezultāti **katram** biomarķierim panelī, `status: "completed"`, un laboratorijas pārskata PDF `documents[]` masīvā. |

Atbilstība nav reģistrjutīga. Katrs cits lauks — tostarp `date_of_birth` un `sex` — tiek saglabāts un
izmantots kā parasti, tāpēc atgrieztie references intervāli atbilst tevis izveidotā profila
reālajam vecumam un dzimumam.

Pieraksts tiek rezervēts **Aniva Test** vietā reālā pieejamā laikā vismaz pēc piecām dienām
no šodienas (vai pirms piecām dienām pagātnes stāvokļiem). Tā izveide neveido laboratorijas pasūtījumu un nepiesaka
kurjeru.

> [!NOTE]
>
> Norādi testa profiliem adresi, kuru kontrolē. Aniva pierakstu atgādinājumus nosaka
> `scheduled_at`, tāpēc gaidāmie testa dati tos nosūtīs, ja vien profilam nav izslēgta saņemšana ar
> `transactional_emails_enabled: false`.

Panelis tiek izvēlēts nejauši no tiem, kurus redz tava API atslēga, tāpēc tā `panel_id` vienmēr ir atrodams
tavā [Paneļu sarakstā](https://docs.anivahealth.com/lv/api/panels/list-panels.md). Klīniskie biomarķieri saņem vērtību
biomarķiera references intervālā; gēni saņem nejaušu genotipu no Aniva references datiem, no kā izriet atbilstošie varianti, klīniskā nozīme un rs ID.

> [!NOTE]
>
> Panelis un vērtības tiek ģenerēti no jauna katrā izveides reizē, tāpēc pārbaudi struktūru, nevis konkrētu
> paneli vai precīzus skaitļus.

## Atbilde

Veiksmes gadījumā API atgriež `201 Created` ar jaunizveidoto profilu.

**id** `string` *required*

Unikāls profila identifikators (UUID).

**handle** `string`

Profila segvārds vai lietotājvārds. Var būt `null`.

**first\_name** `string`

Vārds. Var būt `null`.

**last\_name** `string`

Uzvārds. Var būt `null`.

**email** `string`

E-pasta adrese. Var būt `null`.

**phone** `string`

Tālruņa numurs E.164 formātā. Var būt `null`.

**sex** `integer`

Bioloģiskais dzimums pēc ISO/IEC 5218 (`0` = nezināms, `1` = vīrietis, `2` = sieviete). Var būt `null`.

**date\_of\_birth** `string`

Dzimšanas datums `YYYY-MM-DD` formātā. Var būt `null`.

**height** `number`

Augums centimetros. Var būt `null`.

**weight** `number`

Svars kilogramos. Var būt `null`.

**language** `string`

Vēlamā valoda, viens no 32 iepriekš minētajiem kodiem.

**transactional\_emails\_enabled** `boolean`

Vai šis profils saņem transakciju (programmatiskos) e-pastus. `null`, ja nekad nav iestatīts.

**created\_at** `string`

Profila izveides laika zīmogs ISO 8601 formātā.

**updated\_at** `string`

Pēdējā atjauninājuma laika zīmogs ISO 8601 formātā. `null` jaunizveidotiem profiliem.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Validācijas kļūda — viens vai vairāki lauki neizturēja validāciju. |
| `403` | Aizliegts — tavai API atslēgai nav piekļuves šai darbībai vai profilu grupa ir ārpus tava piekļuves konteksta. |
| `404` | Profilu grupa nav atrasta. |
| `409` | Profils ar norādīto `email` jau eksistē (atbildē ir iekļauta adrese), jau eksistē profils tai pašai personai (skati zemāk), `Idempotency-Key` tika izmantots atkārtoti ar citu pieprasījuma saturu vai tā sākotnējais pieprasījums vēl nav pabeigts. |
| `500` | Iekšēja servera kļūda. |

`409` atbilde izskatās šādi — uztver to kā "šis profils jau eksistē" un sameklē profilu ar
[Profilu sarakstu](https://docs.anivahealth.com/lv/api/profiles/list-profiles.md) (`?email=`), nevis atkārto izveidi:

```json theme={null}
{
  "error": "An account with the email \"maria.schmidt@example.com\" already exists.",
  "error_name": "email_exists_error",
  "email": "maria.schmidt@example.com"
}
```

Persona ar tādu pašu vārdu, uzvārdu, dzimumu un dzimšanas datumu kā profilam, kuru redz tava atslēga,
saņem `409` ar `error_name: "duplicate_profile_error"`. Izmanto atgriezto `profile_id`, nevis
izveido otru profilu:

```json theme={null}
{
  "error": "A patient named \"Maria Schmidt\", born 02-04-1990, with the same biological sex already exists as m***@example.com. Search for that patient and select them instead of creating a duplicate.",
  "error_name": "duplicate_profile_error",
  "profile_id": "3f1c2a8e-5b7d-4c9e-8a21-6d4f0b9e7c35",
  "full_name": "Maria Schmidt",
  "date_of_birth": "1990-04-02",
  "masked_email": "m***@example.com"
}
```

Sandbox uzvārdi, kas izveido testa datus, ir izņēmums.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "first_name": "Maria",
    "last_name": "Schmidt",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "profile_group": "acme-clinic-berlin",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "marketing_emails_enabled": false
  }'
```

```json 201 theme={null}
{
  "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "handle": null,
  "first_name": "Maria",
  "last_name": "Schmidt",
  "email": "maria.schmidt@example.com",
  "phone": "+4930123456789",
  "sex": 2,
  "date_of_birth": "1985-03-22",
  "height": 168,
  "weight": 65,
  "language": "de",
  "transactional_emails_enabled": true,
  "created_at": "2026-04-01T09:14:32Z",
  "updated_at": null
}
```

```json 400 theme={null}
{
  "error": "date_of_birth: Birthdate cannot be in the future."
}
```

```json 404 theme={null}
{
  "error": "Profile group 'acme-clinic-berlin' not found"
}
```


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