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

Aniva Partner API — это REST API, который позволяет медицинским партнерам управлять профилями пациентов, планировать записи на забор крови в пунктах сдачи анализов и запускать пайплайны лабораторных заказов. Ты взаимодействуешь с API по HTTPS с помощью своего партнерского API-ключа.

## Что ты можешь делать

* **Управление профилями** — создавай, получай и обновляй демографические профили пациентов.
* **Планирование записей** — оформляй записи на забор крови в пунктах сдачи анализов Aniva.
* **Управление панелями** — добавляй или удаляй лабораторные панели в существующей записи.
* **Отдельные биомаркеры** — добавляй или удаляй отдельные биомаркеры в записи без выбора панели.
* **Заказы наборов для домашнего теста** — отправляй пациенту набор для домашнего теста по почте, отслеживай посылки и сообщай, когда образец собран.
* **Каталог панелей** — просматривай доступные панели с помощью `GET /api/v1/panels`, чтобы узнать ID панелей и входящие в них биомаркеры.
* **Каталог биомаркеров** — просматривай биомаркеры, которые можно заказать в локации или в наборе для домашнего теста, с помощью `GET /api/v1/biomarkers`, чтобы узнать их ID.
* **Подтверждение забора крови** — отправляй лабораторный код (или коды) после забора крови, чтобы запустить пайплайн лабораторного заказа.
* **Лабораторные результаты** — получай клинические и генетические результаты и скачивай PDF-файлы лабораторных отчетов.
* **Поиск локаций** — получай список доступных пунктов сдачи анализов, чтобы показывать их пациентам.
* **Логистика отправок** — создавай, отслеживай, изменяй и отменяй заказы на курьерскую доставку.
* **Вебхуки** — получай HTTPS-запрос при изменении записи, заказа набора для домашнего теста, его результатов, локации, профиля или отправки. См. [Вебхуки](https://docs.anivahealth.com/ru/concepts/webhooks.md).

## Изучи документацию

> [card] [Аутентификация](https://docs.anivahealth.com/ru/authentication.md)
>
> Аутентифицируй запросы с помощью своего партнерского API-ключа.

> [card] [Быстрый старт](https://docs.anivahealth.com/ru/quickstart.md)
>
> Сделай первый вызов API за несколько минут с помощью пошаговых примеров.

> [card] [Профили](https://docs.anivahealth.com/ru/concepts/profiles.md)
>
> Узнай, как работают профили пациентов и какие данные в них хранятся.

> [card] [Записи](https://docs.anivahealth.com/ru/concepts/appointments.md)
>
> Разберись в жизненном цикле записи — от планирования до подтверждения.

> [card] [Заказы наборов для домашнего теста](https://docs.anivahealth.com/ru/concepts/home-kit-orders.md)
>
> Отправь набор для теста пациенту на дом и отслеживай его, пока образец не дойдет до лаборатории.

## Версионирование API

Текущая версия API — **v1**. Все эндпоинты начинаются с префикса `/api/v1/`. Базовый URL — `https://anivahealth.com`.

```text theme={null}
https://anivahealth.com/api/v1/
```

Несовместимые изменения будут вводиться под новым префиксом версии. API v1 останется доступным с предварительным уведомлением о любом устаревании.

## Даты и часовые пояса

Все моменты времени при передаче имеют формат **UTC ISO 8601** (суффикс `Z`). Календарные поля используют **компоненты местного
времени** (`YYYY-MM-DD`, `HH:MM`).

| Категория | Формат | Где используется |
| - | - | - |
| **Момент времени** | ISO 8601 в UTC (суффикс `Z`, например `2026-04-15T08:30:00Z`) | Каждая дата со временем в ответе — `scheduled_at` записи, `slots[]` доступности, `pickup.from` / `pickup.till` отправки, `created_at`, `updated_at`, `added_at`. Отображай в любом локальном часовом поясе на стороне клиента. |
| **Событие провайдера** | ISO 8601 со смещением вышестоящего провайдера (передается без изменений) | Только `status_updates[].time` отправки — смещение отражает данные, переданные курьерской службой. |
| **Местное время** | `YYYY-MM-DD` для дат, `HH:MM` для времени — без смещения | Календарные даты или время суток — `date_of_birth`, `tested_at` в результатах, `start_date` / `end_date` доступности, `pickup_date` / `pickup_time_from` / `pickup_time_till` отправки, `open_hours` локации. |

Особые примечания:

* **Входные параметры с датой и временем** (например, `scheduled_at` в `POST` / `PATCH /api/v1/appointments`)
  **должны содержать указатель часового пояса** — либо `Z`, либо явное смещение, например `+02:00`. Даты
  со временем без часового пояса отклоняются с кодом `400`. Обе формы кодируют один и тот же момент времени;
  в ответе `scheduled_at` всегда возвращается в UTC `Z`. Используй поле `timezone` локации (или любой другой
  идентификатор IANA), чтобы отформатировать момент времени в местное время при отображении.
* **Входные значения местного времени** интерпретируются в часовом поясе целевого ресурса: даты
  доступности используют query-параметр `timezone` (по умолчанию — часовой пояс локации); `pickup_date` /
  `pickup_time_*` отправки интерпретируются в часовом поясе локации отправления.
* **Поля ответа только с датой** (например, `tested_at`, `availability[].date` доступности) — это
  календарные даты без часового пояса.

## Получение доступа

Aniva выдает API-ключи для каждого партнера отдельно.

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


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