> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Добавить отдельные биомаркеры

> Добавить отдельные биомаркеры в запись

Добавь один или несколько отдельных биомаркеров в запись как выборочные анализы, вне готовой панели. Решения о маршрутизации принимаются далее в цепочке логистики заказов на основе привязок каждого биомаркера к лабораториям.

Итоговый набор синхронно проверяется по правилам комплектности каждой лаборатории. Некоторые биомаркеры можно получить, только заказав их вместе с другими — например, соотношение LDL/HDL приходит в заказе, который также возвращает LDL и HDL, поэтому запрос одного лишь соотношения не образует корректный заказ. (Именно по этим компонентам и *рассчитывается цена* соотношения — см. разбивку `pricing` в [Списке биомаркеров](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md).) Если набор нельзя корректно заказать, запрос возвращает `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"` и списком позиций, в которых он продаётся. См. [Ценообразование](https://docs.anivahealth.com/ru/concepts/pricing.md).

[Список биомаркеров](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md) возвращает для некоторых биомаркеров `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`.

> [!WARNING]
>
> Биомаркеры нельзя добавить после вызова [Подтверждения забора крови](https://docs.anivahealth.com/ru/api/appointments/confirm-blood-draw.md). Попытка изменить подтверждённую запись возвращает `409 Conflict`.

## Запрос

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

**id** `string` *required*

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

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

**biomarker\_ids** `number[]` *required*

Массив ID биомаркеров для добавления. Должен содержать хотя бы один элемент. Используй [Список биомаркеров](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md), чтобы найти ID.

## Ответ

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

**success** `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 не задала цену для этого биомаркера. [Список биомаркеров](https://docs.anivahealth.com/ru/api/biomarkers/list-biomarkers.md) возвращает для него `price_cents: null` или не включает его, если это соотношение с компонентом без цены. Поле `error` равно `biomarker_not_priced`, а `biomarker_id` указывает на этот маркер. Никакой другой биомаркер не исправит эту ошибку, поэтому удали этот биомаркер. Чтобы биомаркер можно было заказать, нужны два условия: лаборатория, в которую Aniva может направить заказ, должна его выполнять, **и** в каталоге Aniva для него должна быть задана цена.

**Ограниченный биомаркер** — биомаркер, который продаётся только в составе позиции, и в наборе нет покрывающей его позиции. Поле `error` равно `biomarker_requires_position`, `biomarker_id` указывает на этот маркер, а `positions[]` перечисляет все позиции, в которых он продаётся, от самой дешёвой. Добавь все биомаркеры одной из них. См. [Ценообразование](https://docs.anivahealth.com/ru/concepts/pricing.md) для описания модели и `pricing.positions` в [Получении биомаркера](https://docs.anivahealth.com/ru/api/biomarkers/get-biomarker.md) для полного состава позиции.

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

| Статус | Описание |
| - | - |
| `400` | Массив `biomarker_ids` пуст или содержит нецелые числа, набор не проходит проверку комплектности (`validation.failures`), добавляется биомаркер, для которого Aniva не задала цену (`error: "biomarker_not_priced"`), в наборе есть ограниченный биомаркер, не покрытый ни одной позицией (`error: "biomarker_requires_position"`), или при капиллярном заборе крови биомаркеры не помещаются в микротейнеры. |
| `403` | Доступ запрещён — отсутствует нужное право доступа или запись находится вне контекста доступа. |
| `404` | Запись или один либо несколько биомаркеров не найдены. |
| `409` | Конфликт — биомаркеры нельзя изменить после подтверждения забора крови. |
| `500` | Внутренняя ошибка сервера. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/biomarkers \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [45, 43, 42]
  }'
```

```json 200 theme={null}
{
  "success": true
}
```

```json 400 (closure validation) theme={null}
{
  "error": "LDL / HDL Ratio cannot be ordered cleanly with this set — add LDL Cholesterol / HDL Cholesterol (see validation.failures for every option).",
  "message": "LDL / HDL Ratio cannot be ordered cleanly with this set — add LDL Cholesterol / HDL Cholesterol (see validation.failures for every option).",
  "validation": {
    "failures": [
      {
        "biomarker_ids": [45],
        "fix_options": [
          {
            "add_biomarkers": [
              { "id": 43, "name": "LDL Cholesterol" },
              { "id": 42, "name": "HDL Cholesterol" }
            ]
          }
        ]
      }
    ]
  }
}
```

```json 400 (biomarker Aniva has not priced) theme={null}
{
  "error": "biomarker_not_priced",
  "message": "Adrenaline, 24h urine carries no price in the catalog you can order from — GET /api/v1/biomarkers/1465 reports price_cents: null for it, and a marker with no price cannot be ordered.",
  "biomarker_id": 1465
}
```

```json 400 (biomarker sold only inside a position) theme={null}
{
  "error": "biomarker_requires_position",
  "message": "Mean Platelet Volume (MPV) is not sold on its own — it comes only inside a position. Add every biomarker of one of the positions listed here; the cheapest is \"Blood Count (extended)\".",
  "biomarker_id": 77,
  "positions": [
    {
      "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
      "name": "Blood Count (extended)",
      "price_cents": 460,
      "retail_cents": 529
    }
  ]
}
```

```json 400 (capillary, does not fit) theme={null}
{
  "error": "Some individual biomarkers need more than 150 µl of one lab's microtainer. Remove some of them."
}
```

```json 409 theme={null}
{
  "error": "Individual biomarkers cannot be modified after blood draw has been confirmed"
}
```

```json 404 theme={null}
{
  "error": "Biomarkers not found: 99999"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.