# Інтеграції в галузі охорони здоров'я

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

Source: https://developers.anpheros.com/uk/guides/healthcare-integrations

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

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

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

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

```bash
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](https://developers.anpheros.com/uk/guides/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 бекендом](https://developers.anpheros.com/uk/guides/integrate-clinic-systems-fhir).

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

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

Вимірювання з пристроїв є `Observation`ами з `author_type: "device"` та кодом LOINC — пульс, артеріальний тиск, SpO₂, вага, глюкоза, кроки, тривалість сну та інші ([FHIR code systems](https://developers.anpheros.com/uk/guides/fhir-code-systems)). Anpheros Daily записує щоденні підсумки, які він зчитує з Apple Health та Health Connect, як Observations у такий самий спосіб. Anpheros не підключається безпосередньо до хмарних сервісів постачальників пристроїв; ваш додаток або бекенд зчитує дані пристрою та записує результат. Як зчитувати дані з Apple Health, Health Connect та Samsung Health та зіставляти кожну метрику з LOINC: [Wearable data in FHIR](https://developers.anpheros.com/uk/guides/wearable-data-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](https://developers.anpheros.com/uk/guides/authentication)

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

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

## SDK

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

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

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

## Пов'язане

- [Як інтегрувати клінічні системи з FHIR бекендом](https://developers.anpheros.com/uk/guides/integrate-clinic-systems-fhir): покроковий посібник для клінічних EMR
- [Як нормалізувати медичні дані](https://developers.anpheros.com/uk/guides/normalize-medical-data): коди, одиниці вимірювання, дати, дублікати, валідація
- [Як імпортувати лабораторні результати до FHIR запису](https://developers.anpheros.com/uk/guides/import-lab-results-fhir): покроковий посібник з CSV та HL7 v2
- [Інтероперабельність медичних даних](https://developers.anpheros.com/uk/guides/interoperability)
- [Healthcare API](https://developers.anpheros.com/uk/guides/healthcare-api)
- [Архітектура](https://developers.anpheros.com/uk/guides/architecture)
- [Сценарії використання](https://developers.anpheros.com/uk/guides/use-cases)