# Интеграции в сфере здравоохранения

> Поддерживаемые сегодня шаблоны интеграции: лабораторные отчеты в одном вызове, клиники, пишущие от имени организации, устройства, сторонние приложения с согласия пациента, веб-хуки и SDK — и то, что недоступно.

Source: https://developers.anpheros.com/ru/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/ru/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/ru/guides/integrate-clinic-systems-fhir).

Поток "согласие → лабораторный `Observation`, записанный проектом клиники → уведомление в приложении пациента" был реализован end-to-end с тестовым проектом клиники.

## Устройства и носимые гаджеты

Измерения от устройств представляют собой `Observation` с `author_type: "device"` и кодом LOINC — частота сердечных сокращений, артериальное давление, SpO₂, вес, уровень глюкозы, количество шагов, продолжительность сна и другие ([FHIR code systems](https://developers.anpheros.com/ru/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/ru/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. приложение видит только этого пациента, только в пределах своих областей видимости, под собственным парным идентификатором.

[Аутентификация и OAuth](https://developers.anpheros.com/ru/guides/authentication)

## События: реакция на изменения

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

## SDK

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

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

- Готовые коннекторы к конкретным госпитальным EHR или лабораторным информационным системам; интеграции строятся на основе API.
- Запуск SMART EHR (запуск внутри EHR); поддерживается только автономный запуск.
- Прямые интеграции с поставщиками медицинского оборудования.

## Связанные материалы

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