Запись на анализы крови прямо из твоего продукта

Один API-ключ даёт тебе 45 эндпоинтов — от записи до лабораторных результатов

Aniva Partner API бронирует забор крови более чем в 25 локациях в Германии, добавляет панели к этой записи и возвращает клинические и генетические результаты в формате JSON. Для каждого запроса нужен один заголовок, а базовый URL одинаков в любой среде.

Когда использовать Aniva

Используй Aniva, когда твоим клиентам нужно записаться на анализ крови
Используй эндпоинты записи для забора крови в клинике и эндпоинты набора для домашнего теста — для набора по почте.
Используй эндпоинты результатов для клинических строк, генетических строк и PDF-отчёта.
Используй эндпоинты каталога, чтобы считывать биомаркеры, панели и единицы, которые продаёт Aniva.
Используй задокументированные пути в https://anivahealth.com/api/v1/ и не придумывай эндпоинты.
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
Базовый сценарий — четыре запроса
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 эндпоинтов задокументированы и работают уже сегодня

1

Для аутентификации нужен всего один заголовок запроса

v1

Каждый путь начинается с префикса v1

25+

Пункты в Германии могут проводить забор крови

Четыре запроса создают рабочую интеграцию

Четыре запроса ведут от записи к результатам из лаборатории

Каждый запрос возвращает ID, который нужен для следующего, поэтому базовая интеграция состоит из четырёх запросов, прежде чем ты добавишь панели, перенос записей или курьеров.

Шаг 01 · GET /locations

Ты указываешь локации, в которые можно записаться с твоим ключом

В ответе ты получаешь каждый адрес, часы работы и часовой пояс, поэтому клиент видит только существующие слоты.

Анализы
Шаг 02 · POST /profiles

Ты создаёшь профиль для клиента

Для профиля нужны имя, код пола, дата рождения и твой profile_group, который принимает UUID или твой собственный slug.

Анализы
Шаг 03 · POST /appointments

Ты оформляешь запись на выбранное время

Для бронирования нужны ID профиля, ID локации и дата со временем в формате ISO 8601 со смещением или суффиксом Z.

Анализы
Шаг 04 · POST /appointments/{id}/confirm

Ты подтверждаешь забор крови по штрихкоду набора

Этот запрос запускает лабораторный заказ и фиксирует запись, поэтому измени все панели до отправки.

Анализы
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
Возможность

Каждая группа ресурсов — это одна REST-коллекция

Ты можешь заказать забор крови в клинике или набор для домашнего теста по почте. Оба варианта возвращаются в одном и том же формате, поэтому ты пишешь код для чтения результатов всего один раз.

Профили · 4 эндпоинта

Профиль — это человек, которого ты тестируешь

Ты находишь профиль по email, создаёшь его в своей группе профилей и позже обновляешь демографические данные.

Анализы
GET /profiles
PATCH /profiles/{id}
Записи · 15 эндпоинтов

В запись входят панели и забор крови

Пятнадцать эндпоинтов охватывают запись и все последующие изменения в ней, включая панели, предпросмотр контейнеров и подтверждение.

Анализы
POST /appointments
GET /appointments/{id}/results
Заказы наборов для домашнего теста · 10 эндпоинтов

Заказы наборов для домашнего теста — это почтовый вариант

Десять эндпоинтов запрашивают набор для самостоятельного тестирования для профиля, меняют его панели и возвращают одинаковую структуру результатов.

Анализы
Создать заказ на набор
Получить результаты
Локации · 2 эндпоинта

Локации показывают, где проходит забор крови

Ты получаешь локации, доступные для записи по твоему ключу, а затем запрашиваешь у одной из них время начала свободных слотов.

Анализы
GET /locations
GET /locations/{id}/availability
Документы · 1 эндпоинт

Результаты приходят в виде клинических и генетических строк

У каждого типа заказа есть свой запрос результатов, а PDF-отчёт скачивается отдельно по ID файла.

Анализы
GET /appointments/{id}/results
GET /documents/{id}
Отправления · 8 эндпоинтов

Курьер доставляет образец в лабораторию

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

Анализы
POST /shipments
Привязать записи
Каталоги · 4 эндпоинта

В каталогах перечислены биомаркеры, которые можно заказать

Каталоги биомаркеров, панелей и единиц измерения разбиты на страницы, а биомаркеры ты можешь фильтровать по месту проведения анализа.

Анализы
GET /biomarkers
GET /panels
Здоровье · 1 эндпоинт

Для одного эндпоинта готовности не нужен API-ключ

Проверка готовности не требует API-ключа, поэтому твой монитор доступности может вызывать ее по расписанию.

Анализы
Публичная проверка готовности
Твоя работа заканчивается на подтверждении штрихкода

Лабораторный процесс запускается, когда ты подтверждаешь забор крови

Ты отправляешь нам штрихкод набора, и это последнее, что нам от тебя нужно. Затем мы организуем контейнеры, курьера и лабораторию, так что твой код вызывает всего два эндпоинта, пока отчёт не будет готов.

The Aniva lab pipeline from confirmation to results Confirming the draw is followed by container selection, courier collection and laboratory analysis, and each biomarker row then reads as planned, received or fault. POST /appointments/{id}/confirmYou confirm the draw GET /appointments/{id}/previewContainers are known POST /shipmentsA courier collects it Aniva laboratory networkThe laboratory analyses planned received fault GET /appointments/{id}/results
Закрашенная точка — нужный тебе путь.Кольцо — состояние, которое тебе всё равно нужно обработать.Оранжевые линии — подтверждённый заказ.
Один парсер обрабатывает и забор крови в клинике, и набор для домашнего теста

У каждого результата два референсных интервала и четыре статуса

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

В строке указано запланировано, пока лаборатория не проведёт анализ.
В строке отображается статус получено, как только приходят значение и единица измерения.
В строке отображается fault, если лаборатория отменила запрос, а status_reason объясняет причину.
GET /api/v1/appointments/{id}/results
{
  "status": "in_progress",
  "clinical_results": [{
    "status": "received",
    "biomarker_name": "Vitamin D",
    "value": 38.5, "unit": "ng/mL",
    "reference_range_lab": { "normal_min": 30, "normal_max": 100 },
    "reference_range_aniva": { "optimal_min": 40, "optimal_max": 60 },
    "tested_at": "2026-04-05"
  }],
  "documents": [{ "file_name": "lab-report-2026-04-05.pdf" }]
}
API использует три формата времени

Для даты и времени нужен часовой пояс, иначе запрос не пройдёт

Дата и время без часового пояса отклоняются с кодом 400 — это главная ошибка большинства первых интеграций.

Временные метки всегда возвращаются в UTC в формате ISO 8601 с суффиксом Z.
Входные данные должны включать явное смещение, поэтому при записи принимается 2026-05-15T12:30:00+02:00.
Обновления по доставке сохраняют смещение, которое передал логистический провайдер.
Календарные поля задаются без привязки к часовому поясу, например дата рождения.
Aniva выпускает и обновляет каждый партнёрский ключ

Для каждого запроса нужен твой партнерский API-ключ

Для аутентификации в каждом запросе используется заголовок x-api-key, а при отсутствии или смене ключа возвращается 403 с короткой ошибкой JSON.

Твой ключ определяет, какие локации, записи и отправления ты можешь видеть.
Никогда не раскрывай свой API-ключ в клиентском коде или публичных репозиториях.
Публичная проверка не требует API-ключа

Ты можешь отслеживать каждый сервис на странице статуса

Страница статуса показывает текущее состояние и историю за 90 дней по каждому сервису, а те же данные доступны в формате JSON для твоего собственного мониторинга.

Партнёрские ключи выдаёт наша команда

Запросить у нас партнерский ключ сегодня

Расскажи нам, на каких рынках ты продаёшь и какие панели тебе нужны, и мы пришлём ключ с нужными правами доступа.

Ты также можешь скачать файл OpenAPI

Эта страница — дизайн-макет. Каждый эндпоинт и полезная нагрузка на ней взяты с docs.anivahealth.com, а схема пайплайна — иллюстративная.

Машиночитаемые копии документации доступны по адресам docs.anivahealth.com/llms.txt и docs.anivahealth.com/llms-full.txt.