> ## 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 за несколько минут: найди пункт сдачи анализов, создай профиль и оформи запись на забор крови.

Это руководство проведет тебя через основной рабочий процесс: поиск пункта сдачи анализов, создание профиля пациента, планирование записи и подтверждение забора крови.

## Что понадобится

Тебе нужен партнерский API-ключ, выданный Aniva.

> [!NOTE]
>
> Если у тебя еще нет API-ключа, свяжись с Aniva, чтобы получить его для своего партнерского аккаунта.

## Шаги

**1. Получить список доступных локаций**

Получи список пунктов сдачи анализов, чтобы найти `location_id` для записи, которую ты планируешь создать.

```bash theme={null}
curl https://anivahealth.com/api/v1/locations \
  -H "x-api-key: YOUR_API_KEY"
```

**Пример ответа**

```json theme={null}
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Aniva Berlin Mitte",
    "company_name": "Aniva GmbH",
    "street": "Unter den Linden",
    "house_number": "42",
    "address_line_2": null,
    "city": "Berlin",
    "state": "Berlin",
    "postal_code": "10117",
    "country_name": "Germany",
    "country_code": "DE",
    "timezone": "Europe/Berlin",
    "contact_phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com",
    "website": "https://anivahealth.com",
    "google_maps_url": null,
    "image_url": null,
    "open_hours": {
      "monday": [{ "open": "08:00", "close": "18:00" }],
      "tuesday": [{ "open": "08:00", "close": "18:00" }],
      "wednesday": [{ "open": "08:00", "close": "18:00" }],
      "thursday": [{ "open": "08:00", "close": "18:00" }],
      "friday": [{ "open": "08:00", "close": "16:00" }],
      "saturday": [],
      "sunday": []
    }
  }
]
```

Запиши `id` локации, которую хочешь использовать. Он понадобится тебе на шаге 3.

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

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

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/profiles \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jordan",
    "last_name": "Rivera",
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "profile_group": "your-profile-group"
  }'
```

**Поля тела запроса**

| Поле | Тип | Обязательно | Описание |
| - | - | - | - |
| `first_name` | string | Да | Имя пациента |
| `last_name` | string | Да | Фамилия пациента |
| `sex` | integer | Да\*\* | `1` = мужской, `2` = женский (ISO/IEC 5218) |
| `date_of_birth` | string | Да\*\* | Дата рождения в формате `YYYY-MM-DD`. Должна быть в прошлом, не ранее 1900 года и соответствовать возрасту 16–100 лет. |
| `profile_group` | string | Да\* | UUID или slug твоей партнерской группы профилей. UUID — стабильная ссылка; slug также принимается. |
| `profile_group_slug` | string | Нет | **Устарело.** Псевдоним slug для `profile_group`. Требуется указать либо `profile_group`, либо `profile_group_slug`. |
| `email` | string | Нет | Email пациента. Генерируется автоматически, если не указан. |
| `language` | string | Нет | `en`, `de` или `fi`. По умолчанию `en`. |
| `phone` | string | Нет | Номер телефона в формате E.164, например `+4915123456789`. |
| `height` | number | Нет | Рост в сантиметрах. |
| `weight` | number | Нет | Вес в килограммах. |
| `transactional_emails_enabled` | boolean | Нет | Переопределяет настройку группы профилей по умолчанию для сервисных писем. |
| `marketing_emails_enabled` | boolean | Нет | Переопределяет настройку группы профилей по умолчанию для маркетинговых писем. |

\*\* Необязательно, если твоя группа профилей позволяет пациенту указать оба поля на странице активации набора. См.
[Профили](https://docs.anivahealth.com/ru/concepts/profiles.md#pozvolit-patsientu-vvesti-datu-rozhdeniya-i-pol).

**Пример ответа (201 Created)**

```json theme={null}
{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "handle": null,
  "first_name": "Jordan",
  "last_name": "Rivera",
  "email": "jordan.rivera@example.com",
  "phone": null,
  "sex": 1,
  "date_of_birth": "1990-04-15",
  "height": null,
  "weight": null,
  "language": "en",
  "transactional_emails_enabled": null,
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": null
}
```

Запиши `id` из ответа. Ты будешь использовать его как `profile_id` на следующем шаге.

**3. Запланировать запись**

Создай запись, используя `profile_id` из шага 2 и `location_id` из шага 1. Укажи в `scheduled_at` время начала слота, которое возвращает [Получение доступности](https://docs.anivahealth.com/ru/api/locations/get-availability.md) для этой локации. API отклонит время, не совпадающее с сеткой слотов.

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "scheduled_at": "2026-04-10T09:00:00Z"
  }'
```

**Пример ответа (201 Created)**

```json theme={null}
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "profile_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "location_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "scheduled_at": "2026-04-10T09:00:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "created_at": "2026-04-01T10:05:00Z",
  "updated_at": null,
  "profile": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "handle": null,
    "first_name": "Jordan",
    "last_name": "Rivera",
    "email": "jordan.rivera@example.com",
    "phone": null,
    "sex": 1,
    "date_of_birth": "1990-04-15",
    "height": null,
    "weight": null,
    "language": "en",
    "transactional_emails_enabled": null,
    "created_at": "2026-04-01T10:00:00Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

Запиши `id` записи. Он понадобится тебе для подтверждения забора крови.

**4. Подтвердить забор крови**

После завершения забора крови отправь лабораторный код (штрихкод пробирки), чтобы подтвердить забор и запустить пайплайн лабораторного заказа. Если на пробирках при заборе указано несколько кодов, вместо этого передается `lab_codes` — см. [Подтверждение забора крови](https://docs.anivahealth.com/ru/api/appointments/confirm-blood-draw.md).

```bash theme={null}
curl -X POST https://anivahealth.com/api/v1/appointments/c3d4e5f6-a7b8-9012-cdef-123456789012/confirm \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lab_code": "7642001234"
  }'
```

**Пример ответа (200 OK)**

```json theme={null}
{
  "success": true
}
```

После подтверждения запускается пайплайн лабораторного заказа. Ты можешь запросить запись, чтобы убедиться, что ее статус изменился на `"blood_drawn"`.

## Следующие шаги

* [Добавь панели к записи](https://docs.anivahealth.com/ru/api/appointments/add-panels.md), чтобы указать, какие лабораторные анализы провести.
* [Обнови запись](https://docs.anivahealth.com/ru/api/appointments/update-appointment.md), чтобы перенести её или изменить место до забора крови.
* [Отмени запись](https://docs.anivahealth.com/ru/api/appointments/cancel-appointment.md), если она больше не нужна.
* [Получи результаты анализов](https://docs.anivahealth.com/ru/api/appointments/get-results.md), чтобы загрузить клинические и генетические результаты после обработки.
* [Скачай документы](https://docs.anivahealth.com/ru/api/documents/download-document.md), чтобы получить PDF-файлы лабораторных отчётов.
* [Запроси профиль](https://docs.anivahealth.com/ru/api/profiles/get-profile.md), чтобы проверить или отобразить данные пациента.
* Изучи полный [справочник API](https://docs.anivahealth.com/ru/api/profiles/create-profile.md) со всеми доступными эндпоинтами и параметрами.


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