Перейти до основного вмісту
Використовуй цей посібник, щоб знайти локацію для аналізів, створити запис для профілю пацієнта й додати потрібні панелі аналізів. Виконай ці кроки до того, як пацієнт прийде на забір крові.
1

Переглянути доступні локації

Отримай список локацій для аналізів, доступних для твого акаунту, надіславши GET-запит на /api/v1/locations.
У відповіді повертається масив об’єктів локацій:
Використовуй поле timezone з об’єкта локації під час формування часової мітки scheduled_at. Переведення часу запису в місцевий часовий пояс локації допомагає уникнути планування поза годинами роботи.
Не визначай доступний для бронювання час лише за open_hours. Виклич Отримати доступність і забронюй час початку слота з відповіді — ця сітка також враховує наявні бронювання, винятки для окремих дат і мінімальний строк завчасного запису.
2

Створити запис

Надішли POST-запит на /api/v1/appointments, вказавши ID профілю, ID локації та бажаний час запису. Час має відповідати початку слота з Отримати доступність.
scheduled_at має бути майбутньою датою і часом у форматі ISO 8601, наприклад 2026-05-12T07:30:00Z. Часові мітки в минулому відхиляються з помилкою 400, як і час у межах 12-годинного мінімального строку завчасного запису у локаціях, якими керує Aniva.
Повторювати цей запит безпечно. Профіль може мати лише один запис для конкретної локації й часу, тому повторний або дубльований запит на створення повертає 409 із наявним appointment_id замість подвійного бронювання пацієнта.
Успішний запит повертає 201 Created з об’єктом запису:
Збережи id запису — він знадобиться, щоб додати панелі й підтвердити забір крові.
3

Додати панелі аналізів

Додай панелі аналізів, які потрібно виконати для зразка крові, надіславши POST-запит на /api/v1/appointments/{id}/panels.ID панелей мають формат UUID. Виклич Список панелей, щоб отримати панелі, які може замовляти твій API-ключ.
Панелі не можна додавати після підтвердження забору крові. Додай усі потрібні панелі до підтвердження — докладніше див. Підтвердити забір крові.
Успішний запит повертає 200 OK із підтвердженням додавання панелей:

Перенесення або скасування

Після створення запису його ще можна змінити до підтвердження забору крові:
  • Перенести або змінити локацію — надішли PATCH-запит на /api/v1/appointments/{id} із полями для оновлення. Див. Оновити запис.
  • Скасувати — надішли DELETE-запит на /api/v1/appointments/{id}. Див. Скасувати запис.
Обидві операції доступні лише до забору крові — тобто поки запис має статус pending або confirmed. Щойно запис переходить у статус blood_drawn, подальші зміни неможливі.

Обробка помилок