Один API-ключ даёт тебе 45 эндпоинтов — от записи до лабораторных результатов
Aniva Partner API бронирует забор крови более чем в 25 локациях в Германии, добавляет панели к этой записи и возвращает клинические и генетические результаты в формате JSON. Для каждого запроса нужен один заголовок, а базовый URL одинаков в любой среде.
Когда использовать Aniva
45 эндпоинтов задокументированы и работают уже сегодня
Для аутентификации нужен всего один заголовок запроса
Каждый путь начинается с префикса v1
Пункты в Германии могут проводить забор крови
Четыре запроса ведут от записи к результатам из лаборатории
Каждый запрос возвращает ID, который нужен для следующего, поэтому базовая интеграция состоит из четырёх запросов, прежде чем ты добавишь панели, перенос записей или курьеров.
Ты указываешь локации, в которые можно записаться с твоим ключом
В ответе ты получаешь каждый адрес, часы работы и часовой пояс, поэтому клиент видит только существующие слоты.
Ты создаёшь профиль для клиента
Для профиля нужны имя, код пола, дата рождения и твой profile_group, который принимает UUID или твой собственный slug.
Ты оформляешь запись на выбранное время
Для бронирования нужны ID профиля, ID локации и дата со временем в формате ISO 8601 со смещением или суффиксом Z.
Ты подтверждаешь забор крови по штрихкоду набора
Этот запрос запускает лабораторный заказ и фиксирует запись, поэтому измени все панели до отправки.
Каждая группа ресурсов — это одна REST-коллекция
Ты можешь заказать забор крови в клинике или набор для домашнего теста по почте. Оба варианта возвращаются в одном и том же формате, поэтому ты пишешь код для чтения результатов всего один раз.
Профиль — это человек, которого ты тестируешь
Ты находишь профиль по email, создаёшь его в своей группе профилей и позже обновляешь демографические данные.
В запись входят панели и забор крови
Пятнадцать эндпоинтов охватывают запись и все последующие изменения в ней, включая панели, предпросмотр контейнеров и подтверждение.
Заказы наборов для домашнего теста — это почтовый вариант
Десять эндпоинтов запрашивают набор для самостоятельного тестирования для профиля, меняют его панели и возвращают одинаковую структуру результатов.
Локации показывают, где проходит забор крови
Ты получаешь локации, доступные для записи по твоему ключу, а затем запрашиваешь у одной из них время начала свободных слотов.
Результаты приходят в виде клинических и генетических строк
У каждого типа заказа есть свой запрос результатов, а PDF-отчёт скачивается отдельно по ID файла.
Курьер доставляет образец в лабораторию
Ты создаёшь заказ курьера с окном забора в будний день, затем прикрепляешь записи и отслеживаешь обновления его статуса.
В каталогах перечислены биомаркеры, которые можно заказать
Каталоги биомаркеров, панелей и единиц измерения разбиты на страницы, а биомаркеры ты можешь фильтровать по месту проведения анализа.
Для одного эндпоинта готовности не нужен API-ключ
Проверка готовности не требует API-ключа, поэтому твой монитор доступности может вызывать ее по расписанию.
Лабораторный процесс запускается, когда ты подтверждаешь забор крови
Ты отправляешь нам штрихкод набора, и это последнее, что нам от тебя нужно. Затем мы организуем контейнеры, курьера и лабораторию, так что твой код вызывает всего два эндпоинта, пока отчёт не будет готов.
У каждого результата два референсных интервала и четыре статуса
Каждая клиническая строка содержит интервал, переданный лабораторией, и интервал Aniva с оптимальным диапазоном, поэтому ты можешь отображать оба без ведения собственной справочной таблицы.
Для даты и времени нужен часовой пояс, иначе запрос не пройдёт
Дата и время без часового пояса отклоняются с кодом 400 — это главная ошибка большинства первых интеграций.
Для каждого запроса нужен твой партнерский API-ключ
Для аутентификации в каждом запросе используется заголовок x-api-key, а при отсутствии или смене ключа возвращается 403 с короткой ошибкой JSON.
Ты можешь отслеживать каждый сервис на странице статуса
Страница статуса показывает текущее состояние и историю за 90 дней по каждому сервису, а те же данные доступны в формате JSON для твоего собственного мониторинга.
Запросить у нас партнерский ключ сегодня
Расскажи нам, на каких рынках ты продаёшь и какие панели тебе нужны, и мы пришлём ключ с нужными правами доступа.
Эта страница — дизайн-макет. Каждый эндпоинт и полезная нагрузка на ней взяты с docs.anivahealth.com, а схема пайплайна — иллюстративная.
Машиночитаемые копии документации доступны по адресам docs.anivahealth.com/llms.txt и docs.anivahealth.com/llms-full.txt.