# API для ЭМК и API медицинских записей

> Как приложения читают и записывают медицинские записи через FHIR: API больничных ЭМК против API медицинских записей под управлением пациента, что покрывает каждое из них, GDPR и хостинг в ЕС, а также HIPAA (BAA и регион США по запросу).

Source: https://developers.anpheros.com/ru/guides/ehr-api

**API ЭМК (API электронных медицинских карт, также называемый API ЭМС или API медицинских записей) позволяет программному обеспечению читать и записывать медицинскую карту пациента — демографические данные, диагнозы, лекарства, аллергии, результаты, документы — через Интернет, обычно в виде ресурсов HL7 FHIR R4 через OAuth.** Поставщики больничных ЭМК, такие как Epic и Oracle Health, предоставляют API FHIR для своих собственных записей, а в США сертифицированные ЭМК должны предоставлять пациентам доступ через такие API. Anpheros — это другой компонент: API медицинских записей под управлением пациента, на основе которого может работать любое приложение, куда клиники, лаборатории, приложения и устройства записывают данные в одну запись FHIR R4 на человека, а для доступа требуется согласие этого человека.

<!-- visual:ehr-stack -->

## Два типа API медицинских записей

| | API больничной ЭМК (например, Epic, Oracle Health) | API записей под управлением пациента (Anpheros) |
|---|---|---|
| Чьи записи | Одна больница или система здравоохранения | Один человек, из всех источников, которые записывают в нее данные |
| Как получить доступ | Регистрация приложения у поставщика, часто для каждой системы здравоохранения | Ключ песочницы для самостоятельного использования; продакшн после соглашения об обработке данных |
| Кто авторизует | Система здравоохранения и пациент для приложений с доступом пациента | Пациент (согласие OAuth) или ваша организация для пациентов, которых она создает |
| Запись данных | Ограничена, зависит от поставщика | Создание, обновление и удаление собственных ресурсов; информация об источнике при каждой записи |
| Стандарт | FHIR R4 (US Core в США) | FHIR R4 плюс более простой REST API |
| Лучше всего подходит для | Чтения данных, записанных больницей | Создания продукта на основе записи, которую люди носят с собой |

Они работают вместе: приложение может считывать данные больничной ЭМК через ее API и вести собственную запись человека в Anpheros, указывая больницу как источник записи.

## Что охватывает API записей Anpheros

| Часть записи | FHIR resource | REST v1 |
|---|---|---|
| Демографические данные | `Patient` | `/v1/patients` |
| Диагнозы | `Condition` (ICD-10) | `/v1/patients/{id}/conditions` |
| Лекарства | `MedicationStatement` (ATC) | `/v1/patients/{id}/medications` |
| Результаты и жизненно важные показатели | `Observation` (LOINC) | `/v1/patients/{id}/observations`, импорт лабораторных данных |
| Документы | `DocumentReference` | `/v1/patients/{id}/documents` |
| Все, по порядку | `Patient/$everything` | `/v1/patients/{id}/timeline` |
| Совместно используемое резюме | `Patient/$summary` (IPS) | — |

```bash
# one patient's active problems, as FHIR
curl "https://platform.anpheros.com/fhir/R4/Condition?patient=$PID&clinical-status=active" \
  -H "Authorization: Bearer $KEY"
```

## Соответствие требованиям и размещение данных

- **GDPR и ЕС:** данные хранятся и обрабатываются в Европейском Союзе (Google Cloud `europe-west4`, Нидерланды); каждое чтение и запись регистрируется и доступно пациенту; доступ других приложений требует согласия пациента.
- **HIPAA:** Anpheros выступает в качестве бизнес-партнера для клиник США. Соглашение о бизнес-партнерстве (BAA) и регион данных США доступны по запросу для производственных клиентов; производство для данных пациентов из США открывается после подписания BAA. До тех пор не храните защищенную медицинскую информацию, подпадающую под действие HIPAA, в Anpheros.

## Часто задаваемые вопросы

### Что такое EHR API?
Интерфейс, с помощью которого программное обеспечение читает и записывает электронные медицинские карты, обычно ресурсы HL7 FHIR R4, такие как Patient, Condition, MedicationStatement и Observation, авторизованные с помощью OAuth и SMART on FHIR.

### В чем разница между EHR API и EMR API?
На практике эти термины используются как взаимозаменяемые. EMR традиционно означает запись одной клиники; EHR — запись, предназначенную для обмена между поставщиками услуг. Сегодня оба обычно предоставляются в виде FHIR API.

### Могу ли я получить доступ к EHR больницы через Anpheros?
Нет. Anpheros не подключается к больничным EHR самостоятельно. Ваше приложение может отдельно читать FHIR API больницы и сохранять то, что разрешает пользователь, в своей записи Anpheros.

### Существует ли бесплатный API медицинских записей для разработчиков?
Да. Песочница Anpheros бесплатна, с 30 синтетическими пациентами по FHIR R4 и REST; производство начинается от 49 евро в месяц.

### Соответствует ли Anpheros требованиям HIPAA?
Anpheros выступает в качестве **бизнес-партнера** для клиник США: соглашение о бизнес-партнерстве (BAA) и регион данных США доступны по запросу для производственных клиентов, в дополнение к письменной программе безопасности (анализ рисков, политики, журнал аудита, шифрование, резервное копирование). Запросите перед сохранением защищенной медицинской информации: производство открывается после подписания BAA. См. [Безопасность, конфиденциальность и местоположение данных](https://developers.anpheros.com/ru/guides/security).

<!-- visual:cta-ehr -->

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

- [Healthcare API](https://developers.anpheros.com/ru/guides/healthcare-api)
- [Patient medical record](https://developers.anpheros.com/ru/guides/patient-medical-record)
- [Longitudinal patient data API](https://developers.anpheros.com/ru/guides/longitudinal-patient-data-api)
- [Patient consent platform for health apps](https://developers.anpheros.com/ru/guides/patient-consent-platform)
- [Security, privacy and data residency](https://developers.anpheros.com/ru/guides/security)
- [How to integrate clinic systems with a FHIR backend](https://developers.anpheros.com/ru/guides/integrate-clinic-systems-fhir)