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`	имя, дата рождения, пол, идентификаторы
Жизненно важные показатели, результаты лабораторных исследований, симптомы, активность, опросы	`/v1/patients/{id}/observations`	`Observation`	LOINC (симптомы: глава R по ICD-10); единицы UCUM
Диагнозы и проблемы	`/v1/patients/{id}/conditions`	`Condition`	ICD-10
Лекарства	`/v1/patients/{id}/medications`	`MedicationStatement`	ATC, название продукта сохраняется в виде текста
Документы (PDF, изображения)	`/v1/patients/{id}/documents`	`DocumentReference`	типы документов LOINC
Полный отчет лаборатории	`POST /v1/patients/{id}/labs/import`	`Observation` (laboratory)	LOINC, если известно, в противном случае собственный код лаборатории
Принятые или пропущенные дозы, вакцинации, аллергии, процедуры, отчеты, планы лечения, цели, направления, визиты, приемы, команды по уходу, семейный анамнез, опросники	`/fhir/R4/{type}`	`MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse`	согласно системам кодирования FHIR

Объекты 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 объединяет наблюдения, состояния, медикаменты, документы, визиты, приемы, вакцинации и эпизоды оказания медицинской помощи в один хронологический список — естественный ввод для экрана истории болезни пациента.

Для всего, что не покрывается 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 удаляет всю запись.

Документы

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

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

Как нормализовать медицинские данные: коды, единицы измерения, даты, дубликаты, валидация
Происхождение медицинских данных: объяснение: кто что написал и как это записать
Healthcare API
Медицинская карта пациента
Создание медицинского приложения
Справочник по API (OpenAPI) · Начало работы

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