Перейти к основному содержанию
PATCH
Добавь один или несколько отдельных биомаркеров в запись как выборочные анализы, вне готовой панели. Решения о маршрутизации принимаются далее в цепочке логистики заказов на основе привязок каждого биомаркера к лабораториям. Итоговый набор синхронно проверяется по правилам комплектности каждой лаборатории. Некоторые биомаркеры можно получить, только заказав их вместе с другими — например, соотношение LDL/HDL приходит в заказе, который также возвращает LDL и HDL, поэтому запрос одного лишь соотношения не образует корректный заказ. (Именно по этим компонентам и рассчитывается цена соотношения — см. разбивку pricing в Списке биомаркеров.) Если набор нельзя корректно заказать, запрос возвращает 400 с данными validation и ничего не сохраняется, поэтому ты можешь методом проб и ошибок подобрать валидный набор:
  1. PATCH … { "biomarker_ids": [45] } (только соотношение LDL/HDL) → 400; в validation.failures[].fix_options[].add_biomarkers указаны LDL и HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (соотношение + LDL + HDL) → 200.
Тот же цикл действует для биомаркеров, которые Aniva продаёт только в составе позиции: запроси такой биомаркер отдельно, и вызов вернёт 400 с error: "biomarker_requires_position" и списком позиций, в которых он продаётся. См. Ценообразование. Список биомаркеров возвращает для некоторых биомаркеров price_cents: null. Эти биомаркеры не курируются: Aniva не задала для них цену. Если ты добавишь такой биомаркер, запрос вернёт 400 с error: "biomarker_not_priced". Никакой другой биомаркер не исправит эту ошибку, потому что null означает, что у тебя нет цены для покупки этого маркера. Исключение — маркеры наборов. Добавь панель, которая является набором, и её компоненты добавятся вместе с ней. Запрос также примет компонент набора, если ты добавляешь его в запись, где уже есть эта панель. При капиллярном заборе крови (draw_method: capillary) кровь распределяется по микротейнерам. Сначала идут панели в порядке бронирования. Затем отдельные биомаркеры заполняют свободный объём микротейнеров с панелями. Когда им нужно больше места, открываются новые микротейнеры. Мы распределяем их равномерно. Каждый микротейнер вмещает не более 150 µl отдельных биомаркеров. Биомаркер, которому требуется более 150 µl в отдельном микротейнере, никогда не поместится, как и биомаркер без заданного объёма. Если итоговый набор нарушает это правило, запрос возвращает 400 с сообщением error, и ничего не сохраняется. Этот запрос идемпотентен: биомаркеры, которые уже есть в записи, сохраняются. Требуются права доступа appointments_schedule и schedule_appointments_with_individual_biomarker_selection.
Биомаркеры нельзя добавить после вызова Подтверждения забора крови. Попытка изменить подтверждённую запись возвращает 409 Conflict.

Запрос

Параметры пути

string
обязательно
Уникальный идентификатор (UUID) записи.

Параметры тела запроса

number[]
обязательно
Массив ID биомаркеров для добавления. Должен содержать хотя бы один элемент. Используй Список биомаркеров, чтобы найти ID.

Ответ

В случае успеха API возвращает 200 OK, подтверждая, что биомаркеры добавлены.
boolean
true, если биомаркеры успешно добавлены в запись.

Разбор ответа 400

Каждый ответ 400 при ошибке проверки комплектности или каталога содержит предложение в message. Ответ 400 при ошибке валидации тела запроса или микротейнеров содержит только error. Разделяй обработку по error. При ошибке проверки комплектности error — это предложение. При ошибке каталога error — это машинный код: biomarker_not_priced или biomarker_requires_position. Проверка комплектности — набор нельзя корректно заказать ни в одной лаборатории:
  • validation.failures[] — присутствует только при ошибках проверки комплектности (отсутствует при обычных ошибках валидации тела запроса). По одной записи на каждую группу биомаркеров, которую не может выполнить ни одна лаборатория, с не прошедшими проверку biomarker_ids и вариантами fix_options[], начиная с наименьшего. Поле add_biomarkers ({ id, name }) каждого варианта — это набор, который нужно добавить ЦЕЛИКОМ: оставь исходные биомаркеры, добавь эти и повтори запрос. Пустой fix_options означает, что добавление не поможет; вместо этого удали биомаркер.
Биомаркер без цены — Aniva не задала цену для этого биомаркера. Список биомаркеров возвращает для него price_cents: null или не включает его, если это соотношение с компонентом без цены. Поле error равно biomarker_not_priced, а biomarker_id указывает на этот маркер. Никакой другой биомаркер не исправит эту ошибку, поэтому удали этот биомаркер. Чтобы биомаркер можно было заказать, нужны два условия: лаборатория, в которую Aniva может направить заказ, должна его выполнять, и в каталоге Aniva для него должна быть задана цена. Ограниченный биомаркер — биомаркер, который продаётся только в составе позиции, и в наборе нет покрывающей его позиции. Поле error равно biomarker_requires_position, biomarker_id указывает на этот маркер, а positions[] перечисляет все позиции, в которых он продаётся, от самой дешёвой. Добавь все биомаркеры одной из них. См. Ценообразование для описания модели и pricing.positions в Получении биомаркера для полного состава позиции.

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