Перейти до основного вмісту
POST
Заплануй запис на забір крові для профілю пацієнта в конкретній локації здачі аналізів. Після створення запис за замовчуванням отримує статус confirmed (у деяких локаціях за замовчуванням може встановлюватися pending — це залежить від налаштувань локації). Виклич Додати панелі, щоб додати панелі аналізу крові перед підтвердженням забору крові.
Профіль може мати щонайбільше один запис на ту саму локацію й час. Спроба створити запис на слот, який профіль уже займає, повертає 409 із наявним appointment_id замість другого запису — тож повторний або випадково продубльований запит ніколи не створить дублікат. Див. Дублікати записів.
Надішли необов’язковий заголовок Idempotency-Key, щоб зробити повторний запит на створення безпечним — повторення з тим самим ключем повертає початкову відповідь замість створення другого запису. Див. Ідемпотентність. Потребує дозволу appointments_schedule.

Запит

Параметри тіла запиту

string
обов'язково
UUID профілю пацієнта, для якого створюється запис.
string
обов'язково
UUID локації здачі аналізів, де відбудеться забір крові. Переглянь Список локацій, щоб знайти доступні ID локацій.
string
обов'язково
Дата й час запису у форматі ISO 8601 (наприклад, 2026-05-15T10:30:00Z або 2026-05-15T12:30:00+02:00). Має містити позначення часового поясу — або Z, або явне зміщення на кшталт +02:00; дати й час без часового поясу відхиляються. Має бути в майбутньому.Має точно збігатися з початком слоту в сітці локації, а в слоті ще мають бути вільні місця — спершу перевір Отримати доступність. Час поза сіткою повертає 400; заповнений слот повертає 409. У локаціях під управлінням Aniva час також має бути щонайменше за 12 годин — див. Мінімальний час до запису.
string[]
До 5 адрес, на кожну з яких надійде один лист, щойно всі результати аналізів будуть остаточними. Лист містить посилання на сторінку результатів в адмінпанелі Aniva. Твій ключ має мати доступ results_view до пацієнта, інакше повернеться 403. Пропусти це поле, щоб використати адреси за замовчуванням для групи пацієнта. Порожній список вимикає ці листи. Див. Листи про готовність результатів.
string
Спосіб забору крові: capillary або venous. Пропусти це поле, щоб використати default_draw_method локації. Цей спосіб має бути в draw_methods локації, інакше повернеться 400.

Відповідь

У разі успіху API повертає 201 Created із новим записом.
string
обов'язково
Унікальний ідентифікатор запису (UUID).
string
обов'язково
UUID профілю, до якого належить цей запис.
string
UUID локації тестування, де відбувається забір крові.
string
Заплановані дата й час запису в UTC (ISO 8601 із суфіксом Z, наприклад 2026-05-15T10:30:00Z). Може бути null.
string
обов'язково
Поточний статус запису. Одне зі значень: pending, confirmed, blood_drawn або cancelled. Детальний статус готовності результатів аналізів можна отримати з Отримати результати, а докладніший прогрес відправлення — із кожного елемента вбудованого масиву shipments (див. нижче) із переходом до Отримати відправлення.
string
Причина скасування у вільній формі, зафіксована під час скасування запису (наприклад, неявка, пізнє скасування, «Помилка. Потрібно повторити»). null, якщо status не дорівнює cancelled.
string[]
обов'язково
Електронні адреси в нижньому регістрі, на кожну з яких надходить один лист, коли всі лабораторні результати стають остаточними. Порожньо, якщо вимкнено. Див. Листи про готовність результатів.
string
обов'язково
Спосіб забору крові: capillary (із пальця або плеча в мікротейнери) або venous (із вени у пробірки). Це спосіб, указаний у записі, або default_draw_method його локації. Після забору крові — це фактично використаний спосіб.
object
обов'язково
Профіль пацієнта, пов’язаний із цим записом.
AppointmentPanel[]
обов'язково
Панелі, які зараз додано до цього запису. Порожній масив для щойно створених записів — додай через Додати панелі. Деталі панелей (назву, біомаркери) можна переглянути через Список панелей.
AppointmentIndividualBiomarker[]
обов'язково
Окремі біомаркери, додані до цього запису поза межами будь-якої панелі. Порожній масив для щойно створених записів — додай через Додати окремі біомаркери. Звір кожен biomarker_id через Список біомаркерів, щоб отримати дані для відображення.
AppointmentShipmentLink[]
обов'язково
Відправлення, прив’язані до цього запису, у порядку прив’язування від найдавнішого. Порожній масив для щойно створених записів — прив’яжи через Створити відправлення (з appointment_id) або Прив’язати записи до відправлення.
string[]
обов'язково
Лабораторні коди (штрихкоди пробірок), зафіксовані для цього запису, у порядку сканування. Порожньо до підтвердження забору крові. Венозний забір крові має один код, надрукований на кожній пробірці; капілярний забір крові має по одному коду на кожен мікротейнер. Результати й документи в Отримати результати посилаються на ці коди через lab_code.

Мінімальний час до запису

Записи в локаціях під управлінням Aniva потрібно бронювати щонайменше за 12 годин наперед; бронювання в межах цього вікна повертає 400. Отримати доступність уже приховує ці слоти, тож усе, що ти отримуєш із цієї сітки, доступне для запису. Локації, якими ти керуєш самостійно, не мають мінімального часу до запису — запис у той самий день і на місці працює без змін.

Дублікати записів

Профіль може мати щонайбільше один нескасований запис на локацію й момент часу — одній людині не можна зробити забір крові двічі в одному місці в один і той самий момент, скільки б крісел не було в локації. Спроба створити запис на слот, який профіль уже займає, повертає 409 із полем appointment_id, що вказує на вже наявний запис:
Обробляй це так, ніби запит уже виконано: отримай запис через Отримати запис, перенеси його через Оновити запис або скасуй через Скасувати запис. Не повторюй запит на створення — він і надалі повертатиме 409. Це робить повторні запити на створення безпечними: запит, повторно надісланий після тайм-ауту, або двічі надіслана форма не зможуть створити два записи для одного пацієнта на той самий час.
appointment_id присутнє лише у відповіді 409 про дублікат. Відповідь 409 через брак місць — коли слот заповнений, бо його зайняли інші пацієнти — повертає лише error, і правильна дія в такому разі — обрати інший слот через Отримати доступність.

Відповіді з помилками