Интеграции и API

Подключение начинается с точного контракта данных.

Для каждого потока заранее фиксируем назначение полей, источник, единицы измерения, права доступа и обработку ошибок.

Публичный API пока закрыт. Тестовая среда доступна в рамках пилота.

01
Цель

Для кого и для какого процесса нужны данные.

Обязательно
02
Контракт

Схема, единицы, идентификаторы и версии.

По проекту
03
Доступ

Роли, согласия, tenant и срок обработки.

По проекту
04
Наблюдение

Ошибки, повторы, audit и критерии остановки.

До запуска

Способы подключения

Канал выбирается по риску и объёму данных

Для каждого канала отдельно подтверждаются состав данных, безопасность и готовность к эксплуатации.

Документы Стартовый сценарий

  • защищённая загрузка;
  • ограниченный набор форматов;
  • распознавание с проверкой;
  • привязка к источнику и версии.

API и события По проекту

  • REST API;
  • webhooks;
  • идемпотентные операции;
  • версионируемые схемы.

Медицинский обмен По запросу

  • FHIR / HL7 по согласованному профилю;
  • SFTP;
  • CSV / XML;
  • сопоставление терминов и единиц.

Контракт данных

BIOS принимает не просто значение, а проверяемый факт

Минимальный контракт должен позволять понять, что передано, откуда, когда, в каких единицах и на каком основании.

01 / Идентификатор

Устойчивая связь с записью

Связь с человеком или эпизодом без неявного смешения записей.

02 / Происхождение

Источник и время

Организация, документ, устройство, автор и точное время события.

03 / Значение

Код, единица и диапазон

Значение интерпретируется только вместе с термином, единицей и применимым референсом.

04 / Версия

Исправление сохраняет прошлую версию

Исправление создаёт новую версию и сохраняет связь с предыдущей.

05 / Доступ

Цель и основание доступа

Передача ограничивается сценарием, ролью, согласием и сроком.

06 / Качество

Ошибка видима

Неизвестное поле, дубль или конфликт не становятся медицинским фактом автоматически.

Этапы интеграции

От первого разговора до стабильной работы

Каждый следующий этап начинается после проверки предыдущего.

01

Задача

Цель, пользователи, владельцы и границы сценария.

02

Сопоставление

Источники, поля, терминология и качество.

03

Безопасность

Доступ, передача, хранение и реакция на инциденты.

04

Пилот

Ограниченный поток, тестовые данные и критерии успеха.

05

Эксплуатация

Наблюдение, версии, поддержка и решение о масштабе.

Границы ответственности

Ответственность фиксируется вместе с контрактом данных

Интеграция не завершена, пока стороны не знают, кто отвечает за источник, сопоставление полей, доступ и реакцию на сбой.

Совместная модель

Интеграционные риски описываются до запуска

Для медицинских данных важно сохранить смысл и происхождение, а также заранее определить получателя результата и его статус проверки.

01

Партнёр

Качество источника, законность передачи и уведомление об изменениях.

02

BIOS

Приём, проверка контракта, происхождение данных и контролируемая обработка.

03

Клиника

Клинические правила, права персонала и врачебная проверка.

04

Вместе

Инциденты, изменения схем, критерии остановки и масштабирование.

Техническая готовность

Что можно запросить сейчас

Материалы выдаются после определения сценария и без передачи реальных медицинских данных на первом этапе.

Начните с одного потока данных.

Источник, контракт, безопасность и измеримый результат.