Перейти до основного вмісту
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 на сторінці Отримати біомаркер, щоб побачити повний склад позиції.

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