Третий компонент того же комплекса — XrayPortalAPI. В отличие от XrayPortal, у которого есть браузерный интерфейс для врачей и лаборантов, XrayPortalAPI — это чисто программный HTTP-интерфейс, предназначенный для взаимодействия радиологической информационной системы с медицинскими информационными системами (МИС), PACS-серверами и другими внешними приложениями.
Задача API — быть единой точкой входа для внешних клиентов, чтобы им не нужно было знать детали подключения к отдельным DICOM-серверам, WorkList или viewer-решениям. Клиентское приложение просто обращается к HTTP API, а он уже сам формирует необходимые DICOM-, RS- и файловые запросы к внутренним компонентам системы.
Что можно делать через API
- получать JWT-токен для авторизованного доступа;
- получать список PACS-серверов и модальностей, зарегистрированных в РИС;
- создавать, искать и редактировать учётные данные пациентов на PACS;
- создавать, искать и удалять направления на исследования (WorkList), в том числе одним запросом вместе с созданием пациента;
- искать законченные исследования пациентов;
- получать ZIP-архивы исследований и временные ссылки на скачивание;
- получать ссылки на открытие исследований в Weasis или сразу открывать их в браузерном вьювере (XrayWebViewer/Oviyam);
- загружать одиночные DICOM-файлы, ZIP-архивы и PDF-документы на PACS;
- читать и создавать структурированные отчёты (DICOM Structured Report, SR).
Типовой сценарий
Обычно всё начинается с направления, сформированного в МИС: пользователь выбирает вид исследования и оборудование, вводит данные пациента — и это направление через API попадает на сервер рабочих списков (WorkList), откуда его считывает модальность. После выполнения исследования изображения уходят на PACS, а клиент через тот же API находит готовое исследование, открывает его в вьювере или скачивает архивом, а по завершении описания может сохранить и прочитать структурированный отчёт (SR) — так заключение врача остаётся доступным даже сторонним DICOM-просмотрщикам, не подключённым к МИС напрямую.
Ошибки в API возвращаются в стандартизированном формате RFC 9457 Problem Details, что упрощает их обработку на стороне клиента любой МИС, независимо от используемого стека технологий.
XrayPortalAPI — это тот самый «клей», который позволяет собрать медицинские информационные системы, PACS-архивы и рабочее место рентгенолога в единый рабочий процесс, не привязывая внешние системы к деталям DICOM-протокола. Если вам интересна архитектура всего комплекса — читайте статью о XrayPortal, а про встроенный просмотрщик изображений — в статье о XrayWebViewer. Вопросы по интеграции — через раздел «Контакты».