Перейти к основному содержанию
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, и в этом случае нужно выбрать другой слот через Получить доступность.

Ответы с ошибками