Перейти до основного вмісту
API

Назви контейнерів у попередньому перегляді запису стають торговими назвами

З наступного релізу containers[].name у Попередньому перегляді запису буде торговою назвою пробірки. type не змінюється, тому читай type, якщо твій застосунок порівнює контейнери.
АдмінпанельAPI

Aniva тепер працює всіма мовами ЄС і ще кількома

API

Один ендпоінт для списку панелей

API

Показуй лабораторні результати у своєму застосунку

Твої пацієнти тепер можуть бачити свої лабораторні результати у твоєму застосунку: список біомаркерів, динаміку кожного біомаркера та 3D Twin з оцінкою для кожної сфери здоров’я. Сторінка використовує колір твого бренду й твій логотип у світлій або темній темі.Сторінка результатів — це платне доповнення, а ціну підкаже твоя контактна особа в Aniva. Створення сесії вбудовування показує, як її налаштувати.
API

Читання списків через API кешується до 5 хвилин

Ці чотири ендпоінти тепер кешують відповідь до 5 хвилин, тому зміни можуть відображатися із затримкою до 5 хвилин:Ендпоінти Get і далі показують зміни одразу.Якщо ти опитуєш API, щоб відстежувати зміни, краще використовуй вебхуки. Вебхук повідомляє тебе про кожну зміну, щойно вона стається. Див. Повторні читання.
Адмінпанель

Дивись, коли кур’єр приїде по твої зразки

В адмінпанелі тепер показано наступний забір кур’єром у твоїй практиці — з відстеженням та етикеткою.Адмінпанель із банером угорі: GO! приїде завтра ~10:00–12:00.Адмінпанель із банером угорі: GO! приїде завтра ~10:00–12:00.
API

Діапазони Aniva тепер доступні

Твої результати тепер можуть містити діапазони Aniva: загальний діапазон і вужчий діапазон для кожного біомаркера разом із джерелами, які зафіксувала Aniva. Діапазони різняться за віком, статтю та тижнем вагітності.Щоб отримати доступ, підпиши коротку угоду щодо діапазонів Aniva. Після цього ми увімкнемо їх для твого API-ключа. Попроси угоду у своєї контактної особи в Aniva.Діапазони містяться в новому полі aniva_range. Воно замінює reference_range_aniva, яке завжди мало значення null. Діапазони є загальною інформацією. Вони не оцінюють результат і не є медичною порадою чи медичним виробом. Стандартом залишається діапазон лабораторії. Див. Діапазони Aniva.
API

Пробірка з фторидом тепер позначається як fluoride

Перегляд контейнерів позначає пробірку з фторидом як fluoride. Старим значенням було naf. Якщо твій код порівнює container.type із naf, зміни його на fluoride.Можуть з’являтися два нові значення: lihep_capillary і fluoride_capillary. Це капілярна пробірка з літій-гепарином і капілярна пробірка з фторидом.
API

Більше жодних подвійних бронювань останнього слота

Якщо два бронювання на останнє місце в слоті надходять одночасно, проходить лише одне. Інше отримує 409, як для будь-якого заповненого слота. Те саме стосується випадків, коли запис змінюють під час його скасування або підтвердження.Підтвердження забору крові має три нові причини для 409:
  • remapped: код тепер відповідає іншим панелям, ніж раніше.
  • sent_to_lab і order_in_flight: лабораторія вже може мати це замовлення, тому код повинен залишатися на своїй пробірці.
APIНабори для домашнього тесту

Суворіші вимоги до адрес доставки в замовленнях наборів для домашнього тесту

Створення набору для домашнього тесту та Оновлення набору для домашнього тесту суворіше перевіряють delivery_address.
  • country_code приймає малі літери, наприклад de. Aniva зберігає й повертає його великими літерами.
  • Для німецької адреси (DE) потрібен postal_code рівно з 5 цифр. Інші значення отримують 400.
  • Ми видаляємо пробіли навколо postal_code перед збереженням.
АдмінпанельНабори для домашнього тестуAPI

Новий набір замість поверненого нам

Коли перевізник повертає нам набір, ми більше не чекаємо на коробку. Повідом нам, що набір потрібен знову, і ми одразу надішлемо новий. Ти також можеш створити його самостійно: виклич Створити набір для домашнього тесту і вкажи повернений набір у replaces_home_kit_order_id. Новий набір — це окреме замовлення з новим кодом набору.Ми перевіряємо повернену коробку, коли вона приходить. Тоді повернений набір змінює статус на cancelled, і ти бачиш, що було в коробці.
РезультатиAPIАдмінпанель

Лист команді, коли результати готові

Попроси нас встановити стандартну електронну адресу для твоєї групи профілів, наприклад поштову скриньку команди. На неї приходитиме лист, коли результати нового запису будуть готові. Це стосується записів з адмінпанелі, з API та від твоїх пацієнтів.Щоб змінити її для одного запису:
  • Адмінпанель: відредагуй електронні адреси або вимкни «Надіслати мені лист, коли результати будуть готові».
  • API: надішли список у results_ready_emails, щоб використати ці електронні адреси замість стандартної. Щоб зберегти свою стандартну електронну адресу, додай її до списку. Надішли [], щоб не надсилати лист.
Дивись Листи про готовність результатів.
APIНабори для домашнього тесту

Пацієнт вводить дату народження та стать

Тепер ми можемо дозволити твоїй групі профілів створювати профіль без date_of_birth і sex. Пацієнт вводить обидва поля на сторінці активації набору, причому дату народження — двічі. Попроси нас увімкнути це. Дивись Профілі.
Адмінпанель

Швидша адмінпанель

Адмінпанель тепер показує перший контент приблизно за 0,2 s замість 1,3 s. Більше жодних індикаторів завантаження. Сторінки заповнюються, щойно надходять дані. Сторінки починають завантажуватися, коли ти наводиш курсор на посилання.
АдмінпанельНабори для домашнього тестуВебхуки

Повернені нам набори

Коли перевізник повертає нам набір, сторінка Набори для домашнього тесту тепер показує його. Відфільтруй за статусом Повернено, щоб побачити кожен набір, який перевізник повернув нам, із причиною від перевізника. Відправлення завершується в fault і надсилає shipment.fault, а вже не delivered. Щойно ми відкриємо коробку, ти також побачиш, що було в ній: повний комплект, бракує частини або набір відкритий. Це покаже тобі, чи отримає твій клієнт повне повернення коштів.Хочеш, щоб ми надіслали набір ще раз? Напиши нам код набору та правильну адресу доставки. Ми відправимо його з тим самим кодом набору.
API

Логарифмічні одиниці

Список одиниць повертає третій unit_type: logarithmic — для значення, яке є логарифмом величини, як-от pH або індекс атерогенності. Показуй його так само, як physical. Не масштабуй його: дві логарифмічні одиниці різняться на зміщення, а не на множник.
APIЦіни

Розрахунок вартості набору для домашнього тесту зі зборами

Розрахувати кошик приймає fulfilment. Надішли home_kit із country_code, і розрахунок додасть позиції набору з твого щомісячного рахунку за одне замовлення: збір за набір, засоби для забору зразків, доставку до цієї країни й назад, чохол і запасний пакет із ланцетами. Стандартним варіантом залишається draw у локації зі зборами за запис. Відповідь вказує, що саме розраховано, у fulfilment.kind.
Concierge

Знайомся з Aniva Concierge

Відтепер наш журнал змін також з’являється у твоєму каналі з нами в Slack, щойно ми щось випускаємо.Ми також створили Aniva Concierge. Маєш запитання про API чи адмінпанель? Згадай @Aniva в Slack або просто відповідай під дописом журналу змін. Він перевірить нашу документацію і підкаже, куди натиснути в адмінпанелі або який ендпоїнт і фільтри використати, з посиланням на сторінку.
APIЗаписи

Список записів за один день

Список записів приймає два нові фільтри. date (YYYY-MM-DD) повертає один календарний день у часовому поясі локації кожного запису, починаючи з найранішого. location_id повертає одну локацію тестування. Використовуй обидва, щоб отримати розклад локації на сьогодні.
APIПрофілі

Дублікати профілів відхиляються

Створити профіль тепер повертає 409 з error_name: "duplicate_profile_error", якщо профіль, видимий для твого ключа, має ті самі ім’я, прізвище, стать і дату народження. У відповіді вказано наявний profile_id. Використовуй його замість створення другого профілю. Прізвища з пісочниці є винятком.
Локації

Aniva Berlin Mitte закривається

З 1 листопада 2026 року Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) більше не приймає записи. Найближча локація — Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
АдмінпанельЦіни

Каталог тестів із твоїми цінами

Новий Каталог тестів в адмінпанелі показує кожен біомаркер із лабораторіями, пробірками та ціною за твоїм тарифом.
APIРезультати

Чому результат не має лабораторного діапазону

Кожен клінічний результат в Отримати результати та Отримати лабораторні результати для наборів для домашнього тесту тепер має reference_range_lab_absent_reason. Це поле вказує, чому reference_range_lab має значення null:
  • not_provided: діапазону немає. Покажи «Не застосовується».
  • lab_text_only: лабораторія вказала лише текст, наприклад цільове значення або рівень ризику. Покажи lab_reported.reference_range.
  • not_measured: результат має статус undeliverable.
Воно має значення null, коли діапазон є. Дивись Результати.
APIЛокації

Роздрібні ціни та координати

Для ендпоїнтів роздрібних цін і цієї події потрібен дозвіл retail_prices_view.
Набори для домашнього тестуАдмінпанель

Замовлення наборів для домашнього тесту в адмінпанелі

Тепер ти можеш замовити пацієнту набір для домашнього тесту на сторінці наборів для домашнього тесту в адмінпанелі. Вибери або створи пацієнта, обери набір і введи адресу доставки. Там ти також можеш скасувати набір.
APIЦіни

Тарифна сітка та розрахунок вартості

Обом новим ендпоїнтам потрібен дозвіл prices_view.
APIРезультати

Більше даних про документи

Кожен елемент у documents в Отриманні результатів тепер містить:Замінений PDF-звіт тепер надсилає results.updated, наприклад фінальний звіт Labor Quade (_E) після попереднього (_V).
APIВебхуки

Вебхуки

Aniva тепер звертається до твого сервера, коли змінюється запис, замовлення набору для домашнього тесту, його результати, локація, профіль або відправлення. Тобі більше не потрібно робити опитування.
  • Зареєструй HTTPS URL через Створення вебхука. Тобі потрібен дозвіл webhooks_manage. Попроси Aniva додати його до твого ключа або налаштувати вебхук за тебе.
  • Події охоплюють кожен статус запису й замовлення набору для домашнього тесту, новий час чи локацію та кожну зміну результатів. results.completed повідомляє, що результати остаточні.
  • Події location.*, profile.* і shipment.* повідомляють, коли локація, профіль або відправлення з’являється, змінюється чи зникає. Відправлення також надсилає shipment.<status> при кожній зміні статусу.
  • Події містять ідентифікатори й статуси, але ніколи не містять лабораторних показників чи персональних даних. Звернися за url у події, щоб отримати дані.
  • Кожен запит підписано за схемою Standard Webhooks.
  • Aniva повторює невдалу доставку 10 разів протягом приблизно трьох днів. Ти можеш переглядати список доставок і надсилати їх повторно протягом 30 днів.
  • Кожен результат в Отриманні результатів тепер має id, тому ти можеш оновити результат, на який вказує подія results.updated.
  • Отримання локації повертає одну локацію за її id. На неї вказує url події location.*.
Див. Вебхуки.
РезультатиАдмінпанель

Надіслати результати клієнту на пошту

Тепер ти можеш надіслати клієнту лист про те, що його лабораторні результати готові. Надішли його зі сторінки лабораторних результатів в адмінпанелі або через два нові ендпоїнти: Надсилання результатів на пошту для записів і Надсилання результатів на пошту для замовлень наборів для домашнього тесту.
  • До листа можна прикріпити лабораторні звіти як PDF-файли. Кожен PDF захищений паролем: пароль — це дата народження клієнта з 8 цифр (ДДММРРРР), і про це вказано в листі.
  • Ти можеш додати особисту примітку до 1 000 символів.
  • У ньому показано назву й логотип основної групи профілів для цього профілю, мовою профілю.
  • Кожне надсилання — це один лист. Повторна спроба надсилає другий лист. Тобі потрібен дозвіл results_view для цього клієнта.

Отримати лист, коли результати готові

Коли ти оформлюєш запис або замовляєш набір для домашнього тесту на заміну в адмінпанелі, ти можеш увімкнути «Надіслати мені лист, коли результати будуть готові». Тоді ми надішлемо один лист тобі або на будь-яку введену тобою адресу, щойно надійдуть усі лабораторні результати. У листі є посилання на результат в адмінпанелі. Клієнт не отримує цей лист. Тобі потрібен дозвіл results_view для цього клієнта.Через API ти можеш вказати до 5 адрес у results_ready_emails у Створенні запису, Створенні замовлення набору для домашнього тесту, Оновленні запису та Оновленні замовлення набору для домашнього тесту.
Набори для домашнього тесту

Передавати телефон і пошту отримувача з кожним набором

Якщо в delivery_address набору для домашнього тесту є phone або email, ми передаємо їх перевізнику. Перевізник тоді повідомляє отримувача, коли посилка в дорозі або чекає в пункті видачі. Якщо ти не вкажеш їх, перевізник не отримає контактів, навіть якщо вони є в профілі. Ти вирішуєш, хто отримує сповіщення від перевізника. У сповіщенні відправником може бути вказано Aniva Health.Див. Створення замовлення набору для домашнього тесту.
Локації

Aniva Berlin P-Berg (Mariposa), Потсдам, Мангайм і Вісбаден

Чотири нові локації для венозного забору крові. Див. Список локацій.
Адмінпанель

Сторінка лабораторних результатів

Нова сторінка лабораторних результатів в адмінпанелі показує кожен забір крові та кожен активований набір для домашнього тесту з його лабораторними звітами. Шукай за ім’ям, датою народження або штрихкодом пробірки. Тобі потрібен дозвіл results_view, а щоб бачити набори — доступ до наборів для домашнього тесту.
Набори для домашнього тесту

API-ключі лише для активації

Новий дозвіл home_kit_orders_activate дає ключу змогу лише активувати набори для домашнього тесту й нічого більше. Він не може створювати, змінювати або скасовувати набір. Попроси в Aniva такий ключ, якщо твої набори активує окрема система.Див. Активація замовлення набору для домашнього тесту.
APIКритичні зміни

Стать має бути чоловічою або жіночою

Створення профілю та Оновлення профілю більше не приймають sex: 0 (невідомо). Передавай 1 для чоловічої або 2 для жіночої статі; 0 повертає 400. Лабораторії потрібна стать для референтних діапазонів, а замовлення для профілю без неї не могло потрапити до лабораторії.Див. Створення профілю.
Набори для домашнього тесту

Набори, що надходять до лабораторії без активації

Якщо зразок надходить до лабораторії до активації набору, Aniva активує набір. activated_at — це ранок першої події відстеження зворотної посилки або ранок, коли зразок надійшов до лабораторії, якщо відстеження немає. Подальший виклик активації з іншим activated_at повертає 409.Див. Активація замовлення набору для домашнього тесту.
API

Діапазони Aniva в результатах

Ендпоїнти результатів тепер заповнюють reference_range_aniva порівняльними значеннями, які склала Aniva, переведеними в одиницю вимірювання результату. Значення відрізняються залежно від віку, статі й тижня вагітності. Твоєму ключу потрібен дозвіл ANIVA_REFERENCE_RANGES_VIEW. Без нього поле має значення null.Див. Отримання результатів запису.
APIНабори для домашнього тесту

Набори на заміну

Замов заміну, якщо за набором не вдалося отримати всі результати. Заміна — це нове замовлення з новим лабораторним кодом, яке зберігає панель початкового замовлення. biomarker_ids визначає, що лабораторія перевірить повторно.Див. Замовлення наборів для домашнього тесту.
APIЦіниКритичні зміни

Одна ціна за біомаркер і панель

Біомаркери й панелі мають одне значення price_cents за твоєю тарифною сіткою, а поруч із ним — retail_cents:
  • > 0: можна замовити окремо.
  • 0: співвідношення (див. requires) або можна замовити лише з іншими маркерами (див. positions).
  • null: не має ціни, тому не можна замовити.
Несумісна зміна: groups[] видалено зі списків і попереднього перегляду запису. Поля ціни retail і yours видалено.Див. Ціноутворення.
API

Ключі ідемпотентності

Ендпоінти створення профілів, записів, замовлень наборів для домашнього тесту та відправлень приймають заголовок Idempotency-Key. Повторний запит із тим самим ключем повертає першу відповідь і нічого не записує.Див. Ідемпотентність.
Локації

Aniva у Ганновері, Дюссельдорфі, Дуйсбурзі та Ессені

Чотири нові локації Aniva в Німеччині відкриті для венозного забору крові: Ганновер, Дюссельдорф, Дуйсбург і Ессен. Виклич Список локацій, щоб побачити локації, доступні для бронювання з твоїм ключем.