Резервирай кръвни изследвания директно от собствения си продукт

Един 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.