Перейти до основного вмісту
GET
Отримай один запис на забір крові за його UUID разом із вкладеним профілем пацієнта. Використовуй цей ендпоїнт, щоб перевірити статус запису, підтвердити деталі планування або отримати пов’язані дані профілю. Потребує дозволу appointments_view або appointments_schedule.

Запит

Параметри шляху

string
обов'язково
Унікальний ідентифікатор (UUID) запису, який потрібно отримати.

Відповідь

У разі успіху API повертає 200 OK із записом і його вкладеним профілем.
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 його локації. Після забору крові — це фактично використаний спосіб.
string
обов'язково
Часова мітка ISO 8601 створення запису.
string
Часова мітка ISO 8601 останнього оновлення. Може бути null.
object
обов'язково
Профіль пацієнта, пов’язаний із цим записом.
AppointmentPanel[]
обов'язково
Панелі, які наразі прикріплені до цього запису. Скасовані прикріплення не включено. Переглянь деталі панелі (назву, біомаркери) через Список панелей.
AppointmentIndividualBiomarker[]
обов'язково
Окремі біомаркери, додані до цього запису поза межами панелей (див. Додати окремі біомаркери). Звіряй кожен biomarker_id зі Списком біомаркерів, щоб отримати дані для відображення.
AppointmentShipmentLink[]
обов'язково
Відправлення, пов’язані з цим записом, у порядку прив’язування від найдавнішого. Порожній масив, якщо пов’язаних відправлень немає. Перевір кожен id через Отримати відправлення, щоб отримати повні дані відправлення (статус, трек-номер, оновлення статусу тощо).
string[]
обов'язково
Лабораторні коди (штрихкоди пробірок), зафіксовані для цього запису, у порядку сканування. Порожньо до підтвердження забору крові. Венозний забір крові має один код, надрукований на кожній пробірці; капілярний забір крові має по одному коду на кожен мікротейнер. Результати й документи в Отримати результати посилаються на ці коди через lab_code.

Повторні виклики

Aniva зберігає відповідь цього ендпоїнта протягом 15 хвилин для кожного API-ключа. Повторний виклик у межах цього часу повертає збережену відповідь, поки запис не змінюється. Після зміни ти отримуєш свіжу відповідь. Заголовки Cache-Status і Age показують, що відповідь збережена та який її вік. Щоб дізнаватися про зміни одразу, підпишись на події вебхуків appointment.created, appointment.rescheduled і подію кожного статусу, наприклад appointment.confirmed. Див. Повторні читання.

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