Перейти до основного вмісту
GET
Отримай клінічні та генетичні лабораторні результати для запису разом із посиланнями на PDF-документи лабораторних звітів. Кожен біомаркер, замовлений у межах запису, з’являється у відповіді, тому ти можеш відстежувати все замовлення, а не лише те, що вже надійшло. Перевіряй status кожного результату перед використанням його value:
  • Аналізи, які ще очікуються, мають статус planned, поки запис перебуває у статусі in_progress.
  • Результати, які лабораторія передала, але які не можна використовувати клінічно, мають статус fault або undeliverable і містять status_reason із поясненням причини. Результат зі статусом fault усе ще має заповнене поле value — це значення хибне. Ніколи не показуй його як результат.
  • Результати, щодо яких Aniva або учасник має сумніви, мають статус likely_wrong і status_reason. Значення не підтверджене. Не показуй його як результат без перевірки.
Кожен отриманий результат і документ містить lab_code (штрихкод пробірки), під яким його зареєстровано, а масив submissions перелічує кожне лабораторне направлення забору крові з його власним статусом — забір крові у кілька пробірок або для кількох лабораторій завершується направлення за направленням. Використовуй Завантажити документ, щоб завантажити PDF-файли лабораторних звітів, посилання на які містяться в масиві documents. Тобі не потрібно опитувати цей ендпоїнт. Підпишись на вебхуки appointment.results.updated або appointment.results.completed і викликай його, коли надходить подія. Опитування все одно працює як резервний варіант. Потребує дозволу results_view.

Запит

Параметри шляху

string
обов'язково
Унікальний ідентифікатор (UUID) запису, для якого потрібно отримати результати.

Відповідь

У разі успіху API повертає 200 OK з об’єктом результатів.
string
обов'язково
Загальний статус результатів. Одне зі значень:
  • in_progress — частина направлень усе ще в лабораторії.
  • completed — усі направлення закрито і щонайменше за одним надійшли результати.
  • fault — усі направлення завершилися невдало без результатів. Більше нічого не очікується.
object[]
обов'язково
Один елемент на кожне лабораторне направлення — забір крові у кілька пробірок або для кількох лабораторій має їх кілька. Верхньорівневий status стає completed, коли кожен елемент закрито і за одним із них надійшли результати.
object[]
обов'язково
Масив клінічних результатів біомаркерів.
object[]
обов'язково
Масив генетичних результатів біомаркерів.
object[]
обов'язково
Документи лабораторних звітів. Використовуй GET /api/v1/documents/{id}, щоб завантажити кожен файл.

Повторні виклики

Aniva зберігає відповідь цього ендпойнта 60 хвилин для кожного API-ключа. Повторний виклик упродовж цього часу отримує збережену відповідь, поки запис і його результати не змінилися. Після зміни ти отримуєш свіжу відповідь. Заголовки Cache-Status і Age показують, що відповідь збережена і як давно її збережено. Щоб дізнаватися про зміни одразу, підпишись на вебхук-події appointment.results.updated, appointment.results.completed та appointment.results.fault. Див. Повторні зчитування.

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