Що ти можеш робити
- Керування профілями — Створюй, отримуй та оновлюй демографічні профілі пацієнтів.
- Планування записів — Бронюй записи на забір крові в локаціях тестування Aniva.
- Керування панелями — Додавай або видаляй панелі лабораторних аналізів у наявному записі.
- Окремі біомаркери — Додавай або прибирай окремі біомаркери в записі без вибору панелі.
- Замовлення наборів для домашнього тесту — Надсилай пацієнту набір для домашнього тесту поштою, відстежуй його посилки та повідомляй, коли зразок зібрано.
- Каталог панелей — Переглядай доступні панелі через
GET /api/v1/panels, щоб дізнатися ID панелей і склад біомаркерів. - Каталог біомаркерів — Переглядай біомаркери, які можна замовити в локації або в наборі для домашнього тесту, через
GET /api/v1/biomarkers, щоб дізнатися їхні ID. - Підтвердження забору крові — Надсилай лабораторний код (або коди) після забору крові, щоб запустити процес лабораторного замовлення.
- Лабораторні результати — Отримуй клінічні та генетичні результати й завантажуй PDF-файли лабораторних звітів.
- Пошук локацій — Отримуй список доступних локацій тестування, щоб показати їх пацієнтам.
- Логістика відправлень — Створюй, відстежуй, змінюй і скасовуй замовлення на кур’єрську доставку.
- Вебхуки — Отримуй HTTPS-виклик, коли змінюється запис, замовлення набору для домашнього тесту, його результати, локація, профіль або відправлення. Див. Вебхуки.
Ознайомся з документацією
Автентифікація
Автентифікуй запити за допомогою свого партнерського ключа API.
Швидкий старт
Зроби свій перший виклик API за кілька хвилин із покроковими прикладами.
Профілі
Дізнайся, як працюють профілі пацієнтів і які дані вони містять.
Записи
Зрозумій життєвий цикл запису від планування до підтвердження.
Замовлення наборів для домашнього тесту
Надішли набір для тестування пацієнту додому та відстежуй його, доки зразок не надійде до лабораторії.
Версіонування API
Поточна версія API — v1. Усі ендпоінти мають префікс/api/v1/. Базовий URL — https://anivahealth.com.
Дати й часові пояси
Усі моменти часу під час передачі подаються у форматі UTC ISO 8601 (суфіксZ). Суто календарні поля використовують складові
місцевого часу (YYYY-MM-DD, HH:MM).
Окремі примітки:
- Вхідні поля дати й часу (наприклад,
scheduled_atуPOST/PATCH /api/v1/appointments) мають містити позначення часового поясу —Zабо явне зміщення, як-от+02:00. Значення без часового поясу відхиляються з кодом400. Обидві форми кодують той самий момент часу; у відповідіscheduled_atзавжди повертається у форматі UTCZ. Використовуй полеtimezoneлокації (або будь-який інший ідентифікатор IANA), щоб відформатувати момент часу в місцевий час під час відображення. - Вхідні поля місцевого часу інтерпретуються в часовому поясі цільового ресурсу: для дат
доступності використовується параметр запиту
timezone(типово — часовий пояс локації); дляpickup_date/pickup_time_*відправлення — часовий пояс локації відправлення. - Поля відповідей лише з датою (наприклад,
tested_at,availability[].dateдоступності) — це календарні дати без часового поясу.
Отримання доступу
Aniva видає ключі API окремо для кожного партнера.Звернися до Aniva, щоб отримати свій партнерський ключ API.