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

# Создать профиль

> Пошаговое руководство: создавай и обновляй профили пациентов в Aniva Partner API до записи на анализ крови.

Используй это руководство, чтобы создать профиль пациента и назначить его в свою группу профилей. Профили — отправная точка для создания записей и запуска лабораторных заказов.

**1. Получи идентификатор группы профилей**

Каждый профиль нужно привязать к группе профилей твоего партнёрского аккаунта. Поле `profile_group` принимает либо неизменяемый UUID группы, либо её человекочитаемый slug — UUID предпочтительнее, так как он никогда не меняется и сохраняется при переименовании slug.

Если ты не знаешь идентификатор своей группы профилей, свяжись с Aniva, чтобы получить его. Без действующего идентификатора создавать профили нельзя.

**2. Создай профиль**

Отправь запрос `POST` на `/api/v1/profiles` с демографическими данными пациента.

> [!NOTE]
>
> Поля `first_name` и `last_name` обязательны. Они принимают только буквы латиницы (включая буквы с диакритикой, например ü), пробелы, дефисы и апострофы. Имена на других алфавитах транслитерируй перед отправкой.

> [!NOTE]
>
> Если не указать `email`, Aniva автоматически создаст технический email-адрес для профиля. Его можно обновить позже с помощью запроса `PATCH`.

> [!TIP]
>
> Поле `language` определяет язык общения Aniva с пациентом — например, в напоминаниях о записи и уведомлениях о результатах. Укажи в нём предпочитаемый язык пациента. Поддерживаемые значения перечислены на странице [Создание профиля](https://docs.anivahealth.com/ru/api/profiles/create-profile.md). По умолчанию `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();
```

Успешный запрос возвращает `201 Created` с объектом нового профиля:

```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
}
```

Сохрани `id` — он понадобится тебе, чтобы создавать записи и обновлять профиль.

**3. Обнови профиль (необязательно)**

Используй `PATCH /api/v1/profiles/{id}`, чтобы обновить любые поля профиля после создания. Все поля необязательны — передавай только те, которые хочешь изменить.

В следующем примере добавляются номер телефона и рост:

```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();
```

Успешный запрос возвращает `200 OK` с полным обновлённым объектом профиля.

## Обработка ошибок

| Статус | Причина | Решение |
| - | - | - |
| `400 Bad Request` | Отсутствует обязательное поле, значение выходит за допустимые пределы или `date_of_birth` некорректна (в будущем, до 1900 года или возраст вне диапазона 16–100 лет). | Посмотри сообщение валидации в теле ответа с ошибкой и исправь запрос. |
| `403 Forbidden` | У твоего API-ключа нет доступа к этой операции или у тебя нет доступа к указанной группе профилей. | Свяжись с Aniva, чтобы уточнить права твоего API-ключа и доступ к группе профилей. |
| `404 Not Found` | Значение `profile_group` не соответствует ни одной группе профилей в твоём аккаунте (ни по UUID, ни по slug). | Проверь, правильно ли указан идентификатор. Свяжись с Aniva, если не уверен в своём UUID или slug. |
| `409 Conflict` | Профиль с таким `email` уже существует (`error_name: "email_exists_error"`), либо `Idempotency-Key` повторно использован с другим телом запроса. | Используй существующий профиль для этого email или отправь новый `Idempotency-Key`. |


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