Один API-ключ дає тобі 45 ендпоінтів — від запису до лабораторних результатів
Aniva Partner API записує на забір крові у понад 25 локаціях у Німеччині, додає панелі до цього запису та повертає клінічні й генетичні результати у форматі JSON. Кожному запиту потрібен один заголовок, а базовий URL однаковий для кожного середовища.
Коли користуватися Aniva
45 ендпоінтів задокументовані та працюють уже сьогодні
Для автентифікації потрібен лише один заголовок запиту
Кожен шлях починається з префікса v1
Пункти в Німеччині можуть виконувати забір крові
Чотири запити ведуть від запису до результатів лабораторії
Кожен запит повертає ID, потрібний для наступного, тому базова інтеграція складається з чотирьох запитів, перш ніж ти додаси панелі, перенесення записів або кур’єрів.
Ти вказуєш локації, які може бронювати твій ключ
У відповіді ти отримуєш кожну адресу, години роботи та часовий пояс, тож клієнт бачить лише наявні слоти.
Ти створюєш профіль для клієнта
Для профілю потрібні ім’я, код статі, дата народження і твоя profile_group, яка приймає UUID або твій власний slug.
Ти бронюєш запис на обраний час
Для запису потрібні ID профілю, ID локації та дата й час у форматі ISO 8601 зі зміщенням або суфіксом Z.
Ти підтверджуєш забір крові за штрих-кодом набору
Цей запит запускає замовлення в лабораторії та фіксує запис, тому зміни всі панелі, перш ніж надсилати його.
Кожна група ресурсів — це одна REST-колекція
Ти можеш замовити забір крові в клініці або набір для домашнього тесту поштою. Обидва варіанти повертаються в однаковому форматі, тож код для зчитування результатів потрібно написати лише раз.
Профіль — це людина, яку ти тестуєш
Ти шукаєш профіль за електронною поштою, створюєш його у своїй групі профілів, а демографічні дані оновлюєш пізніше.
Запис включає панелі та забір крові
П’ятнадцять ендпойнтів охоплюють бронювання та кожну подальшу зміну в ньому, включно з панелями, попереднім переглядом контейнерів і підтвердженням.
Замовлення наборів для домашнього тесту — це поштовий варіант
Десять ендпойнтів запитують DIY-набір для профілю, змінюють його панелі та повертають ту саму структуру результату.
Локації показують, де відбувається забір крові
Ти отримуєш список локацій, у яких твій ключ може бронювати, а потім запитуєш в однієї з них доступний час початку слотів.
Результати надходять у вигляді клінічних і генетичних рядків
Кожен тип замовлення має власний запит на отримання результатів, а 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.