Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Медичний API: що це і як працює

Що таке медичний API, як працює один виклик, на що звернути увагу, і безкоштовний медичний API FHIR R4 зі згодою пацієнта, походженням даних та розміщенням в ЄС — з прикладами та FAQ.

Медичний API — це програмний інтерфейс, через який програмне забезпечення читає та записує медичні дані — записи пацієнтів, спостереження, діагнози, ліки, документи — і через який авторизується доступ до цих даних. Anpheros Platform API — це медичний API, що працює поверх HL7 FHIR R4 запису під контролем пацієнта: програми використовують його для зберігання та отримання медичних даних, отримання згоди пацієнта та сповіщення про зміни.

Як працює виклик медичного API

Незалежно від постачальника, виклик медичного API проходить ті самі перевірки: хто викликає, до якого пацієнта та які дані він може отримати доступ, де зберігаються дані, хто їх написав і кому потрібно знати про їхню зміну.

Типи медичних API

Anpheros поєднує перші два як свою основу, приймає лабораторні результати HL7 v2 як вхідні дані, зберігає документи з їх оригіналами та створює пакети документів FHIR (International Patient Summary). Він також пропонує простіший REST API на основі тих самих даних для розробників, які не хочуть працювати безпосередньо з FHIR.

На що звернути увагу в медичному API

Решта цієї сторінки показує, як кожен із цих пунктів представлений в Anpheros API.

Огляд API Anpheros

Базовий URL: https://platform.anpheros.com. Пісочниця та продакшн використовують його спільно; ключ визначає площину даних.

Автентифікація

• API ключі (sk_test_…, sk_live_…) для ваших серверів; вони бачать пацієнтів, створених вашим проєктом.
• OAuth токени доступу (at_…) для програми, що діє від імені одного пацієнта за згодою.

curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"

Безпечне записування

Запити POST приймають Idempotency-Key: повторний запит з тим самим ключем повертає оригінальну відповідь і нічого не створює. Кожне записування отримує Provenance; тип автора надсилається в тілі (author_type) або в заголовках, таких як X-Anpheros-Author-Type, X-Anpheros-Source-System, X-Anpheros-Origin-Id та X-Anpheros-On-Behalf-Of.

curl -X POST https://platform.anpheros.com/v1/patients/$PID/observations \
     -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" \
     -d '{"code": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'

Помилки та обмеження

FHIR кінцеві точки відповідають OperationOutcome; інші — {"error": {"type", "message", "field"}}. Кожна відповідь містить Anpheros-Request-Id. Стандартне обмеження становить 600 запитів на хвилину на ключ та на IP-адресу. Помилки · Обмеження

Події

Підписані вебхуки для resource.created, resource.updated, resource.deleted, consent.granted, consent.revoked, document.finalized та ping. Вебхуки

Вибір між FHIR та REST v1

Використовуйте FHIR, коли ви вже працюєте з FHIR, потребуєте типів ресурсів, які /v1 не охоплює (наприклад, Immunization, Procedure або CarePlan), або обмінюєтеся даними з іншими FHIR-системами. Використовуйте REST v1 для коду додатків, який потребує плоского JSON для поширених випадків. Обидва варіанти читають і записують одні й ті самі ресурси з однаковими ідентифікаторами, тому проєкт може їх комбінувати. Medical data API детально описує операції з даними.

Часті запитання

Що таке медичний API?

Програмний інтерфейс, за допомогою якого програмне забезпечення читає та записує медичні дані — записи пацієнтів, спостереження, діагнози, ліки та документи — і через який авторизується доступ до цих даних. Сучасні медичні API використовують HL7 FHIR R4 для даних та OAuth 2.0 або 2.1 із SMART on FHIR для авторизації.

Яка різниця між медичним API та FHIR API?

FHIR — це один зі стандартів, якого може дотримуватися медичний API. FHIR API обмінюється ресурсами FHIR через REST; медичний API також може приймати повідомлення HL7 v2, документи або пропрієтарний JSON. Anpheros пропонує FHIR R4 API та простіший REST API для тих самих даних.

Чи існує безкоштовний медичний API для розробників?

Так. Пісочниця Anpheros є безкоштовною та самообслуговуваною: увійдіть за допомогою Google, отримайте ключ API та працюйте з 30 синтетичними пацієнтами через FHIR R4 або REST. Виробництво починається від €99 на місяць, перший місяць безкоштовно.

Як пацієнти надають згоду медичному API?

Через OAuth 2.1 із PKCE: програма надсилає особу на сторінку згоди зі SMART on FHIR scopes; особа обирає, чим ділитися і як довго, може бачити журнал доступу та може відкликати доступ у будь-який час.

Де зберігаються дані?

У Європейському Союзі: сервіс та його бази даних працюють у Google Cloud europe-west4 (Нідерланди).

Який медичний API мені вибрати?

Порівняйте стандарт даних, хто авторизує доступ, походження та аудит, місцезнаходження даних, як поводяться повторні спроби та помилки, і чи можете ви безкоштовно тестувати з реалістичними даними. Платформа медичного API: що вона включає та як вибрати перетворює це на запитання, які слід поставити будь-якому постачальнику.

Пов'язане

• API медичних закладів та API медичних записів
• Платформа API для охорони здоров'я: що вона включає та як вибрати
• Як створити API для охорони здоров'я за допомогою TypeScript: покроковий посібник з Express
• Як зберігати медичні записи за допомогою FHIR R4: покроковий посібник з curl
• API для охорони здоров'я з дозволом пацієнта
• Бекенд SMART on FHIR
• API медичних даних
• Платформа FHIR
• Інтероперабельність медичних даних
• Інтеграції в галузі охорони здоров'я
• Довідник API (OpenAPI) · Аутентифікація та OAuth

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card