Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
API продольных данных пациента
История одного пациента за все время из клиник, лабораторий, приложений и устройств: что требуется для продольной записи и четыре способа ее чтения — временная шкала, $everything, IPS и контекст ИИ.
API для продольных данных пациента возвращает историю здоровья одного человека с течением времени — диагнозы, лекарства, результаты лабораторных исследований, жизненно важные показатели, вакцинации и визиты из каждого источника — в виде одной упорядоченной записи вместо отдельных документов от каждого поставщика. Anpheros хранит эту историю в виде одной записи HL7 FHIR R4 на пациента, созданной клиниками, лабораториями, приложениями и устройствами, с сохранением каждой версии и каждого автора. Разработчики читают ее четырьмя способами: хронологическая временная шкала, полная запись FHIR с Patient/$everything, Международная сводка пациента (International Patient Summary) или компактный контекст для моделей ИИ.
- ClinicsVisits, diagnoses and prescriptions as FHIR R4
- LaboratoriesHL7 v2, CSV or JSON reports become Observations
- Apps and devicesReadings from phones, watches and home devices
- One FHIR recordEvery version kept, every write with provenance
- Your applicationTimeline, $everything, IPS summary or AI context
Что требуется для "продольной" записи
Список результатов сам по себе еще не является продольной записью. Чтобы приложение могло доверять истории, охватывающей годы и разных поставщиков услуг, каждая запись должна содержать:
| Требование | Почему это важно | Как Anpheros это хранит |
|---|---|---|
| Кодированное значение | Значения из разных лабораторий должны быть сопоставимы | LOINC для результатов, ICD-10 для состояний, ATC для лекарств |
| Клиническая дата | Сортировка по дате события, а не по дате загрузки | Даты effective, onset, occurrence в каждом ресурсе |
| Автор | Диагноз врача и заметка пациента — это не одно и то же | Provenance при каждой записи: тип автора, человек, организация, исходная система |
| Каждая версия | Исправления не должны стирать ранее известную информацию | История версий для каждого ресурса (_history) |
| Согласие | Другие приложения видят историю только с согласия человека | OAuth-разрешения с областями действия (scopes), сроком действия и журналом доступа |
Одна запись, много авторов
- Type 2 diabetesCondition · ICD-10 E11 · written by the GP practice
- Metformin 500 mgMedicationStatement · ATC A10BA02
- HbA1c 7.4 %Observation · LOINC 4548-4 · imported from the laboratory
- Influenza vaccineImmunization · written by the pharmacy
- Cardiology visitEncounter · written by the clinic
- Blood pressure 138/86 mmHgObservation · from the patient's app
Condition Medication Observation Immunization Encounter
Четыре способа чтения истории
| Потребность | Конечная точка | Что вы получаете |
|---|---|---|
| Хронологическая лента для экрана | GET /v1/patients/{id}/timeline |
Элементы восьми типов (наблюдение, состояние, медикамент, документ, встреча, запись на прием, иммунизация, эпизод) с датой, заголовком, кратким описанием и ссылкой FHIR; фильтрация с помощью from, to, types |
| Полная запись в формате FHIR | GET /fhir/R4/Patient/{id}/$everything |
Bundle типа searchset; поддерживаются _since, _type, _count и _offset |
| Совместно используемое клиническое резюме | GET /fhir/R4/Patient/{id}/$summary |
Документ International Patient Summary (IPS) |
| Входные данные для модели ИИ | POST /v1/context |
Разделы в пределах бюджетного лимита токенов, каждый факт помечен источником |
Временная шкала с использованием TypeScript SDK:
import { Anpheros, apiKey } from '@anpheros/sdk';
const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) }); // a sandbox key, sk_test_…
const { data: patients } = await anpheros.patients.list();
const page = await anpheros.timeline.list(patients[0].id, {
from: '2025-01-01',
types: 'condition,medication,observation',
limit: 50,
});
for (const item of page.data) console.log(item.date, item.type, item.title);
И та же запись в формате FHIR, ограниченная тем, что изменилось с определенной даты:
curl -H "Authorization: Bearer $ANPHEROS_KEY" \
"https://platform.anpheros.com/fhir/R4/Patient/$PATIENT/\$everything?_since=2026-01-01&_type=Observation,Condition"
Синхронизация вашей копии данных
Если ваше приложение ведет собственный учет истории, подпишитесь на веб-хуки resource.created, resource.updated и resource.deleted. Они также срабатывают, когда другой проект записывает данные в запись, к которой у вас есть доступ, с указанием data.external: true и автора записи в data.source, что позволяет получать данные из других клиник без необходимости периодического опроса.
Ограничения, которые стоит знать
- Запись содержит то, что в нее было внесено. Anpheros самостоятельно не извлекает историю из больниц или национальных сетей; ее записывают клиники, лаборатории, приложения и сам человек.
- Хранятся 26 типов ресурсов FHIR R4. Ресурсы выставления счетов, такие как Claim и ExplanationOfBenefit, не хранятся.
- Другие приложения считывают историю человека только с его согласия; собственный ключ проекта видит пациентов, которых он создал.
Часто задаваемые вопросы
Что такое продольные данные пациента?
Информация о состоянии здоровья человека, собранная за определенный период времени и в различных медицинских учреждениях — диагнозы, лекарства, результаты анализов, жизненно важные показатели, вакцинации и визиты — хранится таким образом, чтобы ее можно было прочитать как одну непрерывную историю.
Какой API предоставляет хронологическое представление истории болезни пациента?
В Anpheros GET /v1/patients/{id}/timeline возвращает записи восьми типов ресурсов в хронологическом порядке с постраничной навигацией, а также фильтрами по дате и типу. Для получения полных данных FHIR используйте Patient/$everything.
Хранится ли история в стандартном формате?
Да. Каждая запись представляет собой ресурс HL7 FHIR R4 со стандартными кодами (LOINC, ICD-10, ATC, CVX, UCUM), а сводка — это International Patient Summary.
Как узнать, кто создал каждую запись?
Каждая запись о внесении изменений создает ресурс Provenance с указанием типа автора (пациент, практикующий врач, устройство, импорт или ИИ), лица, организации и исходной системы.
Могу ли я протестировать с реалистичными продольными данными?
Да. Каждый проект-песочница начинается с 30 синтетических пациентов с данными о состоянии здоровья, лекарствах, результатах лабораторных исследований и жизненно важных показателях примерно за шесть месяцев.
Связанные материалы
- Приложение для ведения личной медицинской карты (PHR) с использованием FHIR: временная шкала в реальном приложении
- Объяснение происхождения медицинских данных
- Платформа согласия пациента для приложений в сфере здравоохранения
- Как хранить медицинские записи с использованием FHIR R4
- ИИ-агенты и медицинские данные: конечная точка контекста
- Вебхуки
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card