# API для продольных данных пациента

> История одного пациента с течением времени из клиник, лабораторий, приложений и устройств: что нужно для продольной записи и четыре способа ее чтения — временная шкала, $everything, IPS и контекст для ИИ.

Source: https://developers.anpheros.com/ru/guides/longitudinal-patient-data-api

**API для продольных данных пациента возвращает историю здоровья одного человека с течением времени — диагнозы, лекарства, результаты лабораторных исследований, жизненно важные показатели, вакцинации и визиты из каждого источника — в виде одной упорядоченной записи вместо отдельных документов от каждого поставщика.** Anpheros хранит эту историю в виде одной записи HL7 FHIR R4 на пациента, созданной клиниками, лабораториями, приложениями и устройствами, с сохранением каждой версии и каждого автора. Разработчики читают ее четырьмя способами: хронологическая временная шкала, полная запись FHIR с `Patient/$everything`, Международная сводка пациента (International Patient Summary) или компактный контекст для моделей ИИ.

<!-- visual:longitudinal-sources -->

## Что требуется для "продольной" записи

Список результатов сам по себе еще не является продольной записью. Чтобы приложение могло доверять истории, охватывающей годы и разных поставщиков услуг, каждая запись должна содержать:

| Требование | Почему это важно | Как Anpheros это хранит |
|---|---|---|
| Кодированное значение | Значения из разных лабораторий должны быть сопоставимы | LOINC для результатов, ICD-10 для состояний, ATC для лекарств |
| Клиническая дата | Сортировка по дате события, а не по дате загрузки | Даты `effective`, `onset`, `occurrence` в каждом ресурсе |
| Автор | Диагноз врача и заметка пациента — это не одно и то же | Provenance при каждой записи: тип автора, человек, организация, исходная система |
| Каждая версия | Исправления не должны стирать ранее известную информацию | История версий для каждого ресурса (`_history`) |
| Согласие | Другие приложения видят историю только с согласия человека | OAuth-разрешения с областями действия (scopes), сроком действия и журналом доступа |

## Одна запись, много авторов

<!-- visual:longitudinal-timeline -->

## Четыре способа чтения истории

| Потребность | Конечная точка | Что вы получаете |
|---|---|---|
| Хронологическая лента для экрана | `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:

```ts
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, ограниченная тем, что изменилось с определенной даты:

```bash
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 синтетических пациентов с данными о состоянии здоровья, лекарствах, результатах лабораторных исследований и жизненно важных показателях примерно за шесть месяцев.

<!-- visual:cta-longitudinal -->

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

- [Приложение для ведения личной медицинской карты (PHR) с использованием FHIR](https://developers.anpheros.com/ru/guides/personal-health-record-app): временная шкала в реальном приложении
- [Объяснение происхождения медицинских данных](https://developers.anpheros.com/ru/guides/medical-data-provenance)
- [Платформа согласия пациента для приложений в сфере здравоохранения](https://developers.anpheros.com/ru/guides/patient-consent-platform)
- [Как хранить медицинские записи с использованием FHIR R4](https://developers.anpheros.com/ru/guides/store-medical-records-fhir)
- [ИИ-агенты и медицинские данные](https://developers.anpheros.com/ru/guides/ai-agents-medical-data): конечная точка контекста
- [Вебхуки](https://developers.anpheros.com/ru/guides/webhooks)