Запис на аналізи крові прямо у твоєму продукті

Один 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 ендпоїнти

Профіль — це людина, яку ти тестуєш

Ти шукаєш профіль за електронною поштою, створюєш його у своїй групі профілів, а демографічні дані оновлюєш пізніше.

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

Запис включає панелі та забір крові

П’ятнадцять ендпойнтів охоплюють бронювання та кожну подальшу зміну в ньому, включно з панелями, попереднім переглядом контейнерів і підтвердженням.

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

Замовлення наборів для домашнього тесту — це поштовий варіант

Десять ендпойнтів запитують DIY-набір для профілю, змінюють його панелі та повертають ту саму структуру результату.

Аналізи
Створити замовлення на набір
Отримати результати
Локації · 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.