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

API für Längsschnitt-Patientendaten

Q: 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.

Die Historie eines Patienten über die Zeit von Kliniken, Laboren, Apps und Geräten: Was eine Längsschnittakte benötigt und vier Möglichkeiten, sie zu lesen – Zeitachse, $everything, IPS und KI-Kontext.

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.

Many sources, one longitudinal record

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

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

One patient, many writers, one timeline (illustrative data)

Mar 2019Type 2 diabetesCondition · ICD-10 E11 · written by the GP practice
Mar 2019Metformin 500 mgMedicationStatement · ATC A10BA02
Sep 2023HbA1c 7.4 %Observation · LOINC 4548-4 · imported from the laboratory
Oct 2024Influenza vaccineImmunization · written by the pharmacy
Jun 2026Cardiology visitEncounter · written by the clinic
Oct 2026Blood pressure 138/86 mmHgObservation · from the patient's app

Condition Medication Observation Immunization Encounter

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:

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:

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.