API для медичних даних: що шукати, як читати та записувати медичну карту за годину

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

Технічна версія для розробників: API для охорони здоров'я · API медичних даних на developers.anpheros.com, із запитами, відповідями та обмеженнями. Ця сторінка є версією простою мовою.

Що має робити API медичних даних

П'ять речей відрізняють придатний для використання API медичних даних від бази даних з HTTP перед нею.

• Стандартний формат. HL7 FHIR R4 — це формат, який використовують лікарні, національні системи та простір медичних даних ЄС. Запис, збережений у FHIR, може бути прочитаний іншими системами без спеціального мосту. Власний JSON — ні.
• Згода пацієнта як об'єкт першого класу. Хто може читати що, як довго, з можливістю відкликання, видиме для пацієнта. Не галочка у вашій власній базі даних.
• Походження. Кожне значення вказує, хто його записав: пацієнт, лікар, пристрій, імпорт, похідний розрахунок. ШІ-асистент, який не може відрізнити лабораторний результат від самостійно введеного припущення, є небезпечним.
• Пісочниця з реалістичними даними. Ви не можете тестувати з реальними пацієнтами, і вам не доведеться самостійно вигадувати 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 standalone launch, щоб додаток міг запитувати у людини доступ до її власного запису.
• Згода зі сферами дії, терміном дії та відкликанням, а також журнал доступу, який пацієнт може переглядати.
• Підписані вебхуки (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, вибираючи сфери дії та тривалість (30, 90, 180 або 365 днів). Дозвіл може бути відкликаний у будь-який час, і пацієнт бачить кожен доступ у журналі доступу. Деталі в моделі згоди.

Де розміщуються дані?

У Європейському Союзі (Cloud Run, europe-west4), з інформацією про походження та історією версій для кожного запису. Виробниче використання вимагає підписаної угоди про обробку даних.

Скільки коштує виробниче середовище?

Виробниче середовище починається від 49 євро на місяць за 2 500 збережених пацієнтів, з першим місяцем безкоштовно; більші плани коштують 199 євро та 799 євро на місяць. Пісочниця залишається безкоштовною. Дивіться ціни.

Чи працює це з ШІ-агентами?

Так. Існує API контексту ШІ з мітками походження та бюджетом токенів, а також сервер MCP на platform.anpheros.com/mcp, до якого може підключитися будь-який помічник, сумісний з MCP. Дивіться Інтеграція ЕМК з медичними ШІ-асистентами.