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

API медичних даних

Куди потрапляють різні типи медичних даних в API Anpheros, як вони кодуються, і як їх записувати, фільтрувати, відстежувати, виправляти та видаляти — з робочими прикладами.

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

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

Для ширшого огляду (автентифікація, згода, події) див. Healthcare API.

Куди потрапляють різні типи медичних даних

Медичні дані	REST v1	FHIR ресурс	Кодування
Особа	`POST /v1/patients`	`Patient`	name, birth date, gender, identifiers
Життєві показники, результати лабораторних досліджень, симптоми, активність, опитування	`/v1/patients/{id}/observations`	`Observation`	LOINC (симптоми: ICD-10 chapter R); UCUM units
Діагнози та проблеми	`/v1/patients/{id}/conditions`	`Condition`	ICD-10
Медикаменти	`/v1/patients/{id}/medications`	`MedicationStatement`	ATC, product name kept as text
Документи (PDF, зображення)	`/v1/patients/{id}/documents`	`DocumentReference`	LOINC document kinds
Повний лабораторний звіт	`POST /v1/patients/{id}/labs/import`	`Observation` (laboratory)	LOINC where known, the lab's own code otherwise
Прийняті або пропущені дози, вакцинації, алергії, процедури, звіти, плани догляду, цілі, направлення, візити, прийоми, команди догляду, сімейний анамнез, анкети	`/fhir/R4/{type}`	`MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse`	per FHIR code systems

Об'єкти REST v1 та ресурси FHIR є однаковими записами з однаковими ідентифікаторами; кожен об'єкт v1 містить посилання fhir.

Запис медичних даних

# a lab result with its reference range, linked to the report it came from
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": "4548-4", "display": "Hemoglobin A1c", "category": "laboratory",
  "value": 6.4, "unit": "%", "effective_at": "2026-09-01T08:00:00Z",
  "reference_range": {"low": 4.0, "high": 5.6},
  "derived_from": ["DocumentReference/'$DOC'"], "author_type": "import"
}'

Категорії спостережень: vital-signs, laboratory, symptom, activity, survey, exam, imaging, social-history.
Складові вимірювання, такі як артеріальний тиск, використовують components (систолічний 8480-6, діастолічний 8462-4 у межах панелі 85354-9).
Типи авторів: patient, practitioner, device, import, ai. Без одного з них платформа записує import.
Коди, які ви не знаєте напам'ять: GET /v1/terminology/loinc?q=hba1c шукає у вбудованому підмножині LOINC, а GET /v1/search?q=metformin — у каталозі симптомів, станів та ліків; спостереження, записане без назви відображення, автоматично отримує назву LOINC.

Читання медичних даних

curl "https://platform.anpheros.com/v1/patients/$PID/observations?category=laboratory&code=4548-4&from=2026-01-01" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/conditions?clinical_status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

Кінцева точка	Фільтри
observations	`category`, `code`, `from`, `to`
conditions	`clinical_status`
medications	`status`
documents	`kind`
timeline	`from`, `to`, `types`

Списки мають сторінки з limit та cursor. timeline об'єднує спостереження (observations), стани (conditions), медикаменти (medications), документи (documents), візити (visits), прийоми (appointments), вакцинації (vaccinations) та епізоди лікування (episodes of care) в один хронологічний список — природний вхід для екрана історії пацієнта.

Для всього, що не охоплюється REST-фільтрами, використовуйте пошук FHIR: GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date (FHIR platform).

Відстеження та виправлення даних

Хто написав: GET /v1/patients/{id}/provenance/{type}/{resourceId} — один запис на версію, з типом автора, проєктом, організацією та вихідною системою.
Кожна версія: GET /fhir/R4/{type}/{id}/_history; оновлюйте за допомогою If-Match, щоб уникнути перезапису змін іншої особи.
Право власності: за згодою ви можете читати те, що написали інші організації, але змінювати або видаляти лише те, що написав ваш проєкт (інакше 403).
Видалення: DELETE /v1/{observations|conditions|medications}/{id}; видалення Patient видаляє весь запис.

Документи

Створіть документ (отримаєте ціль для завантаження), завантажте байти через платформу або безпосередньо до сховища, а потім завершіть. Після завершення оригінал стає незмінним; його SHA-256 та розмір записуються. До 25 МіБ на файл.

Пов'язане

Як нормалізувати медичні дані: коди, одиниці вимірювання, дати, дублікати, валідація
Пояснення походження медичних даних: хто що написав і як це записати
API для охорони здоров'я
Медична карта пацієнта
Створення медичного застосунку
Довідник API (OpenAPI) · Початок роботи

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