API для медицинских данных: что искать, как читать и записывать медицинскую карту за час

"API для здравоохранения" охватывает очень разные вещи: поток HL7 v2 из больницы, национальную службу электронных рецептов, экспорт от поставщика носимых устройств, сервер FHIR. Если вы создаете приложение для здоровья, инструмент для клиники или ИИ-помощник, вам нужно нечто более узкое: бэкенд, который хранит запись пациента в стандартном формате, позволяет пациенту решать, кто ее читает, и предоставляет вам чистый API для доступа к ней. Это руководство рассказывает, на что обратить внимание, и показывает на реальных запросах, как выглядит первый час работы на платформе Anpheros.

Техническая версия для разработчиков: API для здравоохранения · API медицинских данных на developers.anpheros.com с запросами, ответами и ограничениями. Эта страница — версия для широкой аудитории.

Что должен делать API медицинских данных

Пять вещей отличают пригодный для использования API медицинских данных от обычной базы данных с HTTP-интерфейсом.

• Стандартный формат. HL7 FHIR R4 — это формат, который используют больницы, национальные системы и европейское пространство данных здравоохранения. Запись, хранящаяся в FHIR, может быть прочитана другими системами без специального моста. Проприетарный JSON — нет.
• Согласие пациента как первоклассный объект. Кто может читать что, как долго, с возможностью отзыва, видимое пациенту. Не просто галочка в вашей собственной базе данных.
• Происхождение данных (Provenance). Каждое значение указывает, кто его записал: пациент, врач, устройство, импорт, производный расчет. ИИ-помощник, который не может отличить результат лабораторного анализа от предположения, сделанного самим пациентом, опасен.
• Песочница с реалистичными данными. Вы не можете тестировать на реальных пациентах, и вам не придется самостоятельно создавать 30 синтетических пациентов с шестимесячной историей.
• Местоположение данных, которое вы можете указать. Для европейских пользователей это означает серверы в ЕС, подпадающие под действие GDPR, с соглашением об обработке данных.

Два способа доступа: REST и FHIR, одни и те же данные

Платформа Anpheros предоставляет доступ к одной и той же записи дважды. Простой REST API (/v1) для кода продукта и строгий FHIR R4 (/fhir/R4) для всего, что должно взаимодействовать с остальной частью системы здравоохранения. Идентификаторы в обоих случаях идентичны; каждый объект v1 содержит ссылку на свой fhir-аналог.

export BASE=https://platform.anpheros.com
export KEY=sk_test_…

# пациенты, видимые вашему проекту
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# результаты лабораторных анализов, от новейших
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# активные лекарства
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# все в одном временном ряду
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# те же данные, строгий FHIR
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

За этими запросами стоят 26 типов ресурсов FHIR (Patient, Observation, Condition, MedicationStatement, AllergyIntolerance, Immunization, DocumentReference, Encounter, Consent, Provenance и другие), кодированные с использованием LOINC для измерений, ICD-10 для состояний и ATC для лекарств.

Получение ключа займет минуту

Песочница работает в режиме самообслуживания и бесплатно. Войдите в панель управления на platform.anpheros.com/dashboard, нажмите Получить ключ для песочницы, и у вас появится организация, проект песочницы и ключ sk_test_…. Проект поставляется с собственной копией 30 синтетических пациентов: взрослых, детей и пожилых людей из разных стран ЕС, с заболеваниями, лекарствами, аллергиями, результатами анализов и жизненными показателями за шесть месяцев. Изменяйте или удаляйте что угодно; сброс вернет их обратно.

Производственные ключи (sk_live_…) выдаются проверенным организациям с подписанным соглашением об обработке данных. Песочница и производственная среда — это разные базы данных: ключ песочницы физически не может получить доступ к реальным данным пациента.

Что еще есть в комплекте

• OAuth 2.1 с PKCE и автономный запуск SMART on FHIR, чтобы приложение могло запросить у человека доступ к его собственной записи.
• Согласие с областями действия (scopes), сроком действия и возможностью отзыва, а также журнал доступа, который может прочитать пациент.
• Подписанные вебхуки (HMAC-SHA256, с повторными попытками и экспоненциальной задержкой) для событий resource.created, consent.granted, consent.revoked, document.finalized.
• API контекста ИИ, который создает резюме пациента с метками происхождения данных в пределах лимита токенов.
• Импорт лабораторных отчетов из CSV, HL7 v2 ORU^R01 или JSON, с сопоставлением с LOINC.
• Международное резюме пациента ($summary) и SMART Health Links для обмена по QR-коду.
• SDK для Dart и TypeScript, ссылка на OpenAPI по адресу /docs и CapabilityStatement по адресу /fhir/R4/metadata.

Полное руководство с ответами доступно по адресу developers.anpheros.com/guides/first-hour.

Частые вопросы

Есть ли бесплатный API для здравоохранения, с которого я могу начать сегодня?

Да. Песочница Anpheros бесплатна и работает в режиме самообслуживания: войдите, получите ключ, и у вас будет 30 синтетических пациентов для чтения и записи. Ограничения составляют 10 000 записей ресурсов в день, 100 ваших собственных пациентов и 250 МБ документов на проект.

REST или FHIR, что мне использовать?

Используйте /v1 для кода вашего собственного продукта: он проще и возвращает обычный JSON. Используйте /fhir/R4, когда данные должны быть прочитаны другой системой, когда вам нужен поиск FHIR, _history, $everything или $summary, или когда это требуется для сертификации. Оба варианта работают с одной и той же записью.

Как обрабатывается согласие пациента?

Человек предоставляет приложению доступ к своей записи через OAuth, выбирая области действия (scopes) и продолжительность (30, 90, 180 или 365 дней). Предоставленный доступ может быть отозван в любое время, и пациент видит каждое чтение в журнале доступа. Подробности в модели согласия.

Где размещаются данные?

В Европейском Союзе (Cloud Run, europe-west4), с указанием происхождения данных и истории версий при каждой записи. Производственное использование требует подписанного соглашения об обработке данных.

Сколько стоит производство?

Производство начинается с 49 евро в месяц за 2 500 хранимых пациентов, первый месяц бесплатно; более крупные тарифы стоят 199 евро и 799 евро в месяц. Песочница остается бесплатной. См. цены.

Работает ли это с ИИ-агентами?

Да. Существует API контекста ИИ с метками происхождения данных и лимитом токенов, а также сервер MCP по адресу platform.anpheros.com/mcp, к которому может подключиться любой ИИ-ассистент с поддержкой MCP. См. Интеграция ЭМК с ИИ-медицинскими ассистентами.