Перейти до основного вмісту
GET
Повертає каталог біомаркерів із пагінацією, які твій API-ключ може замовити для одного джерела забору. Додавай їх до записів або до наборів для домашнього тесту. Архівовані біомаркери виключено. Біомаркер потрапляє до списку, якщо його забезпечує замовлення в лабораторії, якою може користуватися твій ключ, і забір за цим замовленням виконується лише в ті контейнери, які є в цьому джерелі. Вирішальне значення мають пробірки для зразків, а не тип аналіту. Потребує дозволу panels_access. Для об’єкта pricing також потрібен дозвіл prices_view.

Запит

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

Джерело забору має один із двох форматів: локація тестування або набір для домашнього тесту. Передай рівно одне. Якщо не передати жодного або передати обидва, повернеться 400.
string
обов'язково
Локація, де проводиться забір крові за записами. Біомаркер потрапляє до списку, якщо забір за його замовленням виконується лише в контейнери, які є в цій локації. Зістав зі Списком локацій.
string
Перевизначає прайс-лист, який використовує price_cents: retail або id прайс-листа, яким може користуватися твій ключ. Цей id повертає Отримати прайс-лист. За замовчуванням використовується прайс-лист платіжного акаунта твого API-ключа, інакше — роздрібний. retail_cents завжди відповідає роздрібному прайс-листу.
number
Максимальна кількість результатів у відповіді (1–1 000). Пропусти параметр, щоб отримати весь відповідний каталог — його розмір обмежений (щонайбільше кілька тисяч рядків). Якщо параметр пропущено, pagination.limit повторює значення total.
number
за замовчуванням:"0"
Зміщення пагінації. Має бути ≥ 0.

Відповідь

Biomarker[]
Масив біомаркерів, що відповідають запиту.
object

Об’єкти цін

Ціноутворення має єдину структуру скрізь, де воно трапляється — у біомаркерах, панелях, у попередньому перегляді запису та розрахунку вартості. Ціноутворення пояснює модель, що лежить в основі; це довідник полів. Усі суми вказано в цілих центах.
integer | null
Скільки це коштує за твоїм прайс-листом. 0 — це реальна нульова ціна: елемент не продається окремо, а блок requires або positions поруч вказує, як він продається натомість. null означає інше: Aniva не встановила ціну, це не безплатно, його не можна замовити, і він нічого не додає до жодної суми.
integer | null
Та сама сума за рекомендованим роздрібним прайс-листом. Завжди присутнє; дорівнює price_cents, якщо твій ключ уже використовує роздрібний прайс-лист.
"routine" | "specialty"
Який із двох тарифів Aniva у твоєму прайс-листі визначає ціну цього маркера. Присутнє лише тоді, коли маркер має власну ціну.
object[]
Комерційні пропозиції, що містять цей біомаркер, від найдешевшої. За price_cents: 0 це єдиний спосіб його замовити; за додатного price_cents це пакети, до яких він також входить. Позиція оплачується один раз і завжди надається повністю.
string
Стабільний ідентифікатор позиції. Пов’язується з via_position у рахунку за запис.
string
Назва позиції для партнера.
integer | null
Скільки коштує вся позиція у твоїй тарифній картці, сплачується один раз. Поруч іде retail_cents.
number[]
Усі біомаркери, які надає позиція, включно із запитаним.
number[]
Інші елементи, крім запитаного біомаркера — те, що йде разом із ним, коли ти його купуєш.
object[]
Присутнє, коли цей біомаркер є співвідношенням. Його замовлення додає ці компоненти до кошика за їхніми власними цінами, і компонент оплачується один раз на кошик, хоч скільки співвідношень на нього спирається. Власне price_cents співвідношення нараховується додатково до його компонентів. Більшість співвідношень коштують 0. Кожен елемент містить id, name, price_cents і retail_cents.Співвідношення, у якого не всі компоненти мають ціну, взагалі відсутнє в каталозі — воно ніколи не з’являється з price_cents: null.
Панелі мають лише price_cents і retail_cents: у панелі єдина ціна в каталозі, без позицій і компонентів.

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