Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Медичні інтеграції

Підтримувані на сьогодні шаблони інтеграції: лабораторні звіти одним викликом, клініки, що записують від імені організації, пристрої, треті сторони зі згодою, вебхуки та SDK — і що недоступно.

Інтеграція в галузі охорони здоров'я з'єднує систему, яка виробляє або потребує медичних даних — лабораторію, клініку, пристрій, іншу програму — із записом пацієнта. З Anpheros кожна інтеграція проходить через той самий API та ті самі правила: дані записуються як HL7 FHIR R4, приписуються своєму джерелу, видимі пацієнту та надаються іншим сторонам лише за згодою пацієнта. Ця сторінка описує шаблони інтеграції, які платформа підтримує сьогодні.

Перегляньте каталог інтеграцій Anpheros, щоб побачити кожну інтеграцію з її перевіреним статусом (доступна, бета або посібник розробника), даними та ресурсами FHIR, якими вона обмінюється, її напрямком, автентифікацією та документацією.

Лабораторії: повні звіти за один виклик

Лабораторія або будь-яка система, що зберігає лабораторні звіти, надсилає повний звіт, а платформа перетворює кожен результат на лабораторний Observation:

curl -X POST https://platform.anpheros.com/v1/patients/$PID/labs/import \
     -H "Authorization: Bearer $KEY" -H "Content-Type: text/csv" \
     -H "X-Anpheros-Source-System: labx" -H "Idempotency-Key: report-2026-0917-77" \
     --data-binary @report.csv

• Формати: CSV (румунські або англійські заголовки, приймається десяткова кома), HL7 v2 ORU^R01 та JSON.
• Маркери зіставляються з LOINC, коли звіт надає код або назва відповідає термінології платформи; інші зберігають власний код лабораторії та перелічуються як unmapped.
• Кожен рядок отримує стабільний ідентифікатор, тому повторне надсилання того самого звіту пропускає вже імпортоване.
• До 500 рядків на запит; кожен результат несе походження, вказуючи вихідну систему та звіт.

Деталі: Lab connector.

Клініки: запис від імені організації

Клініки та люди, які там працюють, є ресурсами каталогу (Organization, Practitioner, PractitionerRole). Система клініки може вказати, хто стоїть за кожним запитом:

• X-Anpheros-Acting-As: PractitionerRole/<id> — практикуючий лікар, який працює через вашу програму; записується в журнал доступу та відображається пацієнту за іменем;
• X-Anpheros-On-Behalf-Of: Organization/<id> — організація, для якої здійснюється запис;
• X-Anpheros-Author-Ref: Practitioner/<id> — автор, зареєстрований у Provenance.

За згодою пацієнта клініка читає весь запис, включаючи те, що написали інші організації, і змінює лише те, що написала сама. Кілька ресурсів можна записати атомарно за допомогою FHIR transaction bundle (POST /fhir/R4).

Практичний приклад, від каталогу до візиту, записаного як одна транзакція: Як інтегрувати системи клінік з FHIR бекендом.

Потік згоди → лабораторний Observation, написаний проєктом клініки → сповіщення в додатку пацієнта, був реалізований наскрізно за допомогою тестового проєкту клініки.

Пристрої та носимі пристрої

Вимірювання з пристроїв є Observationами з author_type: "device" та кодом LOINC — пульс, артеріальний тиск, SpO₂, вага, глюкоза, кроки, тривалість сну та інші (FHIR code systems). Anpheros Daily записує щоденні підсумки, які він зчитує з Apple Health та Health Connect, як Observations у такий самий спосіб. Anpheros не підключається безпосередньо до хмарних сервісів постачальників пристроїв; ваш додаток або бекенд зчитує дані пристрою та записує результат. Як зчитувати дані з Apple Health, Health Connect та Samsung Health та зіставляти кожну метрику з LOINC: Wearable data in FHIR.

Сторонні додатки: доступ за згодою

Додаток, який бажає отримати дані, що людина вже зберігає в Anpheros, реєструється один раз і запитує згоду через OAuth 2.1 з PKCE (SMART on FHIR standalone launch):

1. GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access — розміщена сторінка згоди;
2. людина обирає запис та тривалість (30, 90, 180 або 365 днів);
3. POST /oauth/token обмінює код на токен доступу (30 хвилин) та змінний токен оновлення (30 днів);
4. додаток бачить лише цього пацієнта, лише в межах своїх областей дії (scopes), під власним парним ідентифікатором (pairwise id).

Автентифікація та OAuth

Події: реагування на зміни

Замість опитування зареєструйте вебхук. Доставлення підписується за допомогою HMAC-SHA256, повторюється з експоненційним відкотом до 24 годин і містить ідентифікатори, але ніколи клінічний вміст. Коли інший проєкт записує дані до запису, до якого ви маєте доступ, подія повідомляє про це (data.external: true, із джерелом). Вебхуки

SDK

TypeScript (@anpheros/sdk) та Dart / Flutter (anpheros_sdk) SDK реалізують усе вищезазначене — імпорт лабораторних даних (labs.importCsv, labs.importHl7, labs.importItems), OAuth з PKCE, керування вебхуками та перевірку підпису. SDK

Що недоступно

• Готові конектори до конкретних лікарняних EHR або лабораторних інформаційних систем; інтеграції будуються проти API.
• Запуск SMART EHR (запуск всередині EHR); підтримується лише автономний запуск.
• Прямі інтеграції з постачальниками пристроїв.

Пов'язане

• Як інтегрувати клінічні системи з FHIR бекендом: покроковий посібник для клінічних EMR
• Як нормалізувати медичні дані: коди, одиниці вимірювання, дати, дублікати, валідація
• Як імпортувати лабораторні результати до FHIR запису: покроковий посібник з CSV та HL7 v2
• Інтероперабельність медичних даних
• Healthcare API
• Архітектура
• Сценарії використання

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card