# Longitudinal patient data API

> One patient's history over time from clinics, labs, apps and devices: what a longitudinal record needs, and four ways to read it — timeline, $everything, IPS and AI context.

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

**Eine Longitudinal Patient Data API gibt die Krankengeschichte einer Person über die Zeit zurück – Diagnosen, Medikamente, Laborergebnisse, Vitalparameter, Impfungen und Besuche von jeder Quelle – als eine geordnete Aufzeichnung anstelle separater Dokumente pro Anbieter.** Anpheros speichert diese Historie als eine einzige HL7 FHIR R4 Aufzeichnung pro Patient, geschrieben von Kliniken, Laboren, Apps und Geräten, wobei jede Version und jeder Autor erhalten bleibt. Entwickler lesen sie auf vier Arten: eine chronologische Zeitleiste, die vollständige FHIR-Aufzeichnung mit `Patient/$everything`, eine International Patient Summary oder ein kompakter Kontext für KI-Modelle.

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

## Was "longitudinal" erfordert

Eine Liste von Ergebnissen ist noch keine longitudinale Aufzeichnung. Damit eine Anwendung einer Historie vertrauen kann, die sich über Jahre und Anbieter erstreckt, muss jeder Eintrag Folgendes enthalten:

| Anforderung | Warum es wichtig ist | Wie Anpheros es speichert |
|---|---|---|
| Eine kodierte Bedeutung | Werte von verschiedenen Laboren müssen vergleichbar sein | LOINC für Ergebnisse, ICD-10 für Zustände, ATC für Medikamente |
| Ein klinisches Datum | Sortierung nach dem Zeitpunkt des Ereignisses, nicht nach dem Zeitpunkt des Hochladens | `effective`, `onset`, `occurrence` Daten auf jeder Ressource |
| Der Autor | Eine ärztliche Diagnose und eine Notiz des Patienten sind nicht gleichwertig | Provenance bei jedem Schreibvorgang: Autorentyp, Person, Organisation, Quellsystem |
| Jede Version | Korrekturen dürfen nicht das löschen, was zuvor bekannt war | Versionshistorie auf jeder Ressource (`_history`) |
| Zustimmung | Andere Anwendungen sehen die Historie nur, wenn die Person zustimmt | OAuth-Berechtigungen mit Scopes, Ablaufdatum und einem Zugriffslog |

## Ein Datensatz, viele Schreiber

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

## Vier Möglichkeiten, die Historie zu lesen

| Bedarf | Endpunkt | Was Sie erhalten |
|---|---|---|
| Ein chronologischer Feed für einen Bildschirm | `GET /v1/patients/{id}/timeline` | Elemente von acht Typen (observation, condition, medication, document, encounter, appointment, immunization, episode) mit Datum, Titel, Zusammenfassung und der FHIR-Referenz; Filterung mit `from`, `to`, `types` |
| Der vollständige Datensatz als FHIR | `GET /fhir/R4/Patient/{id}/$everything` | Ein Searchset Bundle; `_since`, `_type`, `_count` und `_offset` werden unterstützt |
| Eine teilbare klinische Zusammenfassung | `GET /fhir/R4/Patient/{id}/$summary` | Ein International Patient Summary (IPS) Dokument |
| Eingabe für ein KI-Modell | `POST /v1/context` | Abschnitte innerhalb eines Token-Budgets, jede Tatsache mit ihrer Quelle gekennzeichnet |

Die Zeitachse mit dem 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);
```

Und derselbe Datensatz als FHIR, beschränkt auf Änderungen seit einem Datum:

```bash
curl -H "Authorization: Bearer $ANPHEROS_KEY" \
  "https://platform.anpheros.com/fhir/R4/Patient/$PATIENT/\$everything?_since=2026-01-01&_type=Observation,Condition"
```

## Ihre Kopie synchron halten

Wenn Ihre Anwendung ihre eigene Ansicht der Historie pflegt, abonnieren Sie die Webhooks `resource.created`, `resource.updated` und `resource.deleted`. Diese werden auch ausgelöst, wenn ein anderes Projekt in einen Datensatz schreibt, auf den Sie Zugriff haben, mit `data.external: true` und dem Schreiber in `data.source`, sodass Daten von anderen Kliniken Sie ohne Abfragen erreichen.

## Zu beachtende Limits

- Der Datensatz enthält, was hineingeschrieben wurde. Anpheros ruft nicht eigenständig Verlaufsdaten von Krankenhäusern oder nationalen Netzwerken ab; Kliniken, Labore, Apps und die Person selbst schreiben sie hinein.
- 26 FHIR R4 Ressourcentypen werden gespeichert. Abrechnungsressourcen wie Claim und ExplanationOfBenefit werden nicht gespeichert.
- Andere Anwendungen lesen die Historie einer Person nur mit deren Zustimmung; ein eigener Schlüssel eines Projekts sieht die von ihm erstellten Patienten.

## Häufig gestellte Fragen

### Was sind Längsschnitt-Patientendaten?
Gesundheitsinformationen einer Person, die über einen Zeitraum und über verschiedene Versorgungsumgebungen hinweg gesammelt werden – Diagnosen, Medikamente, Ergebnisse, Vitalwerte, Impfungen und Besuche –, die so aufbewahrt werden, dass sie als eine kontinuierliche Historie gelesen werden können.

### Welche API liefert eine chronologische Ansicht des Patientenakten?
In Anpheros gibt `GET /v1/patients/{id}/timeline` Einträge aus acht Ressourcentypen in Datumsreihenfolge zurück, mit Paging sowie Datums- und Typfiltern. Für die vollständigen FHIR-Daten verwenden Sie `Patient/$everything`.

### Wird die Historie in einem Standardformat gespeichert?
Ja. Jeder Eintrag ist eine HL7 FHIR R4-Ressource mit Standardcodes (LOINC, ICD-10, ATC, CVX, UCUM), und die Zusammenfassung ist ein International Patient Summary.

### Woher weiß ich, wer jeden Eintrag erstellt hat?
Jeder Schreibvorgang erstellt eine Provenance-Ressource mit dem Autorentyp (patient, practitioner, device, import oder AI), der Person, der Organisation und dem Quellsystem.

### Kann ich mit realistischen Längsschnittdaten testen?
Ja. Jedes Sandbox-Projekt beginnt mit 30 synthetischen Patienten mit etwa sechs Monaten an Diagnosen, Medikamenten, Laborergebnissen und Vitalwerten.

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

## Verwandte Themen

- [Personal Health Record (PHR) App mit FHIR](https://developers.anpheros.com/de/guides/personal-health-record-app): Eine Zeitleiste in einer echten App
- [Erklärung der Herkunft medizinischer Daten](https://developers.anpheros.com/de/guides/medical-data-provenance)
- [Plattform für Patienteneinwilligung für Gesundheits-Apps](https://developers.anpheros.com/de/guides/patient-consent-platform)
- [Speichern medizinischer Aufzeichnungen mit FHIR R4](https://developers.anpheros.com/de/guides/store-medical-records-fhir)
- [KI-Agenten und medizinische Daten](https://developers.anpheros.com/de/guides/ai-agents-medical-data): Der Kontext-Endpunkt
- [Webhooks](https://developers.anpheros.com/de/guides/webhooks)