> ## 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: создавай, обновляй и привязывай людей, для которых ты заказываешь анализы крови и наборы для домашнего теста.

Профиль — это карточка пациента или пользователя в системе Aniva. Каждая запись, лабораторный заказ и результат связаны с профилем.

## Группы профилей

При создании профиля ты привязываешь его к **группе профилей** с помощью параметра `profile_group`. Группа профилей организует профили в твоём партнёрском аккаунте и закрепляет их за конкретной программой или интеграцией.

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

Значение `profile_group` (UUID или slug) обязательно при создании. Старое поле `profile_group_slug` по-прежнему принимается как устаревший псевдоним.

## Поля

**id** `string` *required*

UUID, автоматически созданный Aniva. Используй его для ссылок на профиль в других запросах API.

**handle** `string`

Необязательное имя пользователя или псевдоним для профиля. Может быть null.

**first\_name** `string`

Имя пациента. Только латинские символы, 1–100 символов. Обязательно при создании.

**last\_name** `string`

Фамилия пациента. Только латинские символы, 1–100 символов. Обязательна при создании — лаборатории
отклоняют заказы для пациента без фамилии. Может быть null в профилях, созданных до того, как это
поле стало обязательным.

**email** `string`

Адрес электронной почты пациента. Если не указать его при создании, Aniva автоматически создаст
адрес-заглушку.

**phone** `string`

Номер телефона в [формате E.164](https://www.itu.int/rec/T-REC-E.164/en) (например,
`+14155552671`). Может быть null.

**sex** `integer`

Биологический пол по [ISO/IEC 5218](https://www.iso.org/standard/36266.html): `1` = мужской, `2` =
женский. Обязателен при создании, если твоя группа профилей не позволяет пациенту указать его
самостоятельно (см. ниже). Он нужен лаборатории для референсных интервалов, поэтому создание или
обновление со значением `0` (неизвестно) вернёт `400`. Профили, созданные до 30 сентября 2026
года, всё ещё могут возвращать `0`.

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

Дата рождения в формате `YYYY-MM-DD`. Обязательна при создании, если твоя группа профилей не
позволяет пациенту указать её самостоятельно (см. ниже). Должна быть в прошлом, не раньше 1900
года и соответствовать возрасту от 16 до 100 лет; неправдоподобные значения отклоняются с кодом
`400`. Дата рождения передаётся в лабораторию в заказе и не может быть изменена после его
оформления.

**height** `number`

Рост в сантиметрах. Может быть null.

**weight** `number`

Вес в килограммах. Может быть null.

**language** `string`

Предпочитаемый язык для сообщений пациенту. Допустимые значения: `en`, `de`, `fi`.

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

Получает ли профиль транзакционные письма, например подтверждения записи и уведомления о
готовности результатов. Отдельно от согласия на маркетинговую рассылку. Значение null, если
никогда не задавалось.

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

Метка времени создания профиля в формате ISO 8601.

**updated\_at** `string`

Метка времени последнего обновления в формате ISO 8601. Значение null, если профиль никогда не
обновлялся.

> [!NOTE]
>
> Поля `first_name`, `last_name`, `sex`, `date_of_birth` и `profile_group` обязательны при создании
> профиля. Все остальные поля необязательны. Старое поле `profile_group_slug` по-прежнему
> принимается как устаревший псевдоним для `profile_group`.

### Позволить пациенту ввести дату рождения и пол

Мы можем включить одну настройку для твоей группы профилей. Тогда ты сможешь создать профиль без
`date_of_birth` и `sex`. Попроси нас включить её. Без неё создание без любого из этих полей вернёт
`400`.

Пациент вводит оба значения на странице активации набора (`anivahealth.com/activate`) вместе с кодом
набора. Страница запрашивает дату рождения дважды, потому что лаборатория не сможет изменить её
позже. После этого набор открывается только с этой датой рождения. Пока пациент не введёт оба
значения, мы придерживаем заказ в лабораторию. Используй эту настройку только с наборами для
домашнего теста.

## Жизненный цикл

У профилей простой жизненный цикл:

1. **Создание** — зарегистрируй профиль с обязательными демографическими полями и `profile_group` (UUID
   или slug).
2. **Обновление** (необязательно) — добавь или измени поля, например `phone`, `height` или `weight`.
3. **Привязка** — свяжи профиль с записями, указав его `id` как `profile_id`.

[Вебхук](https://docs.anivahealth.com/ru/concepts/webhooks.md) `profile.*` сообщает, когда профиль появляется, изменяется или удаляется.

## Пример профиля

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