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

> Ceļvedis soli pa solim: izveido un atjaunini pacientu profilus Aniva partneru API, pirms piesaki asins analīzes.

Izmanto šo ceļvedi, lai izveidotu pacienta profilu un piešķirtu to savai profilu grupai. Profili ir sākumpunkts pierakstu plānošanai un laboratorijas pasūtījumu uzsākšanai.

**1. Iegūt savas profilu grupas atsauci**

Katrs profils jāpiešķir profilu grupai, kas pieder tavam partnera kontam. Laukā `profile_group` var norādīt grupas nemainīgo UUID vai cilvēkam lasāmo slug — priekšroka dodama UUID, jo tas nekad nemainās un saglabājas arī pēc slug pārdēvēšanas.

Ja nezini savas profilu grupas atsauci, sazinies ar Aniva, lai to iegūtu. Bez derīgas atsauces profilus izveidot nevar.

**2. Izveidot profilu**

Nosūti `POST` pieprasījumu uz `/api/v1/profiles` ar pacienta demogrāfiskajiem datiem.

> [!NOTE]
>
> Gan `first_name`, gan `last_name` ir obligāti. Tajos pieļaujami tikai latīņu alfabēta burti (tostarp burti ar diakritiskajām zīmēm, piemēram, ü), atstarpes, defises un apostrofi. Vārdus citos rakstos pirms iesniegšanas transliterē.

> [!NOTE]
>
> Ja izlaidīsi `email`, Aniva profilam automātiski izveidos pagaidu e-pasta adresi. To vēlāk varēsi atjaunināt ar `PATCH` pieprasījumu.

> [!TIP]
>
> Lauks `language` nosaka valodu, kurā Aniva sazinās ar pacientu — piemēram, pieraksta atgādinājumos un paziņojumos par rezultātiem. Iestati to atbilstoši pacienta vēlamajai valodai. Lapā [Izveidot profilu](https://docs.anivahealth.com/lv/api/profiles/create-profile.md) ir norādītas atbalstītās vērtības. Noklusējuma vērtība ir `en`.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "first_name": "Emma",
    "last_name": "Müller",
    "sex": 2,
    "date_of_birth": "1990-04-15",
    "profile_group": "my-clinic-group",
    "email": "emma.muller@example.com",
    "language": "de"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch('https://anivahealth.com/api/v1/profiles', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    first_name: 'Emma',
    last_name: 'Müller',
    sex: 2,
    date_of_birth: '1990-04-15',
    profile_group: 'my-clinic-group',
    email: 'emma.muller@example.com',
    language: 'de',
  }),
});

const profile = await response.json();
```

Veiksmīgs pieprasījums atgriež `201 Created` ar jauno profila objektu:

```json theme={null}
{
  "id": "a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56",
  "handle": null,
  "first_name": "Emma",
  "last_name": "Müller",
  "email": "emma.muller@example.com",
  "phone": null,
  "sex": 2,
  "date_of_birth": "1990-04-15",
  "height": null,
  "weight": null,
  "language": "de",
  "transactional_emails_enabled": null,
  "created_at": "2026-04-01T09:14:22Z",
  "updated_at": null
}
```

Saglabā `id` — tas būs nepieciešams pierakstu plānošanai un profila atjaunināšanai.

**3. Atjaunināt profilu (neobligāti)**

Izmanto `PATCH /api/v1/profiles/{id}`, lai pēc izveides atjauninātu jebkurus profila laukus. Visi lauki ir neobligāti — iekļauj tikai tos, kurus vēlies mainīt.

Šajā piemērā tiek pievienots tālruņa numurs un augums:

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56 \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "phone": "+4915123456789",
    "height": 168.5
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/profiles/a3f1c2e4-58b7-4d9e-b012-3c7f8a2e1d56',
  {
    method: 'PATCH',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      phone: '+4915123456789',
      height: 168.5,
    }),
  }
);

const updated = await response.json();
```

Veiksmīgs pieprasījums atgriež `200 OK` ar pilnu atjaunināto profila objektu.

## Kļūdu apstrāde

| Statuss | Cēlonis | Risinājums |
| - | - | - |
| `400 Bad Request` | Trūkst obligātā lauka, vērtība ir ārpus diapazona vai `date_of_birth` nav ticams (nākotnē, pirms 1900. gada vai norāda uz vecumu ārpus 16–100 gadiem). | Pārbaudi kļūdas atbildes pamattekstā norādīto validācijas ziņojumu un izlabo pieprasījumu. |
| `403 Forbidden` | Tavai API atslēgai nav piekļuves šai darbībai vai tev nav piekļuves norādītajai profilu grupai. | Sazinies ar Aniva, lai apstiprinātu savas API atslēgas atļaujas un piekļuvi profilu grupai. |
| `404 Not Found` | `profile_group` vērtība neatbilst nevienai profilu grupai tavā kontā (ne pēc UUID, ne pēc slug). | Pārbaudi, vai atsauce ir pareiza. Sazinies ar Aniva, ja neesi pārliecināts par savu UUID vai slug. |
| `409 Conflict` | Šim `email` jau eksistē profils (`error_name: "email_exists_error"`), vai `Idempotency-Key` tika izmantots atkārtoti ar citu pieprasījuma saturu. | Izmanto esošo profilu šim e-pastam vai nosūti jaunu `Idempotency-Key`. |


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