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

API de données patient longitudinales

Q: Quelle API donne une vue chronologique du dossier d'un patient ?

Dans Anpheros, GET /v1/patients/{id}/timeline renvoie les entrées de huit types de ressources par ordre de date, avec pagination et filtres de date et de type. Pour les données FHIR complètes, utilisez Patient/$everything.

L'historique d'un patient au fil du temps provenant de cliniques, laboratoires, applications et appareils : ce dont un dossier longitudinal a besoin, et quatre façons de le lire — chronologie, $everything, IPS et contexte IA.

Une API de données longitudinales du patient renvoie l'historique de santé d'une personne au fil du temps — diagnostics, médicaments, résultats de laboratoire, signes vitaux, vaccinations et visites de toutes les sources — sous la forme d'un seul enregistrement ordonné au lieu de documents séparés par fournisseur. Anpheros conserve cet historique sous la forme d'un seul enregistrement HL7 FHIR R4 par patient, écrit par des cliniques, des laboratoires, des applications et des appareils, en conservant chaque version et chaque auteur. Les développeurs le lisent de quatre manières : une chronologie, l'enregistrement FHIR complet avec Patient/$everything, un International Patient Summary (IPS), ou un contexte compact pour les modèles d'IA.

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

Ce que "longitudinal" requiert

Une liste de résultats n'est pas encore un enregistrement longitudinal. Pour qu'une application puisse faire confiance à un historique couvrant des années et des fournisseurs, chaque entrée doit porter :

Exigence	Pourquoi c'est important	Comment Anpheros le stocke
Une signification codée	Les valeurs de différents laboratoires doivent être comparables	LOINC pour les résultats, ICD-10 pour les conditions, ATC pour les médicaments
Une date clinique	Tri par date d'événement, pas par date de téléchargement	Dates `effective`, `onset`, `occurrence` sur chaque ressource
L'auteur	Le diagnostic d'un médecin et la note d'un patient ne sont pas égaux	Provenance à chaque écriture : type d'auteur, personne, organisation, système source
Chaque version	Les corrections ne doivent pas effacer ce qui était connu auparavant	Historique des versions sur chaque ressource (`_history`)
Consentement	D'autres applications ne voient l'historique que si la personne est d'accord	Octrois OAuth avec scopes, expiration et journal d'accès

Un enregistrement, plusieurs rédacteurs

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

Quatre façons de lire l'historique

Besoin	Endpoint	Ce que vous obtenez
Un flux chronologique pour un écran	`GET /v1/patients/{id}/timeline`	Éléments de huit types (observation, condition, médication, document, rencontre, rendez-vous, immunisation, épisode) avec date, titre, résumé et la référence FHIR ; filtrez avec `from`, `to`, `types`
Le dossier complet en FHIR	`GET /fhir/R4/Patient/{id}/$everything`	Un Bundle de type searchset ; `_since`, `_type`, `_count` et `_offset` sont supportés
Un résumé clinique partageable	`GET /fhir/R4/Patient/{id}/$summary`	Un document International Patient Summary (IPS)
Entrée pour un modèle d'IA	`POST /v1/context`	Sections dans un budget de tokens, chaque fait étiqueté avec sa source

La chronologie avec le SDK TypeScript :

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);

Et le même dossier en FHIR, limité à ce qui a changé depuis une date :

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

Garder votre copie synchronisée

Si votre application conserve sa propre vue de l'historique, abonnez-vous aux webhooks resource.created, resource.updated et resource.deleted. Ils se déclenchent également lorsqu'un autre projet écrit dans un enregistrement auquel vous avez accès, avec data.external: true et l'auteur dans data.source, afin que les données d'autres cliniques vous parviennent sans interroger.

Limites à connaître

L'enregistrement contient ce qui y a été écrit. Anpheros ne récupère pas l'historique des hôpitaux ou des réseaux nationaux de sa propre initiative ; les cliniques, les laboratoires, les applications et la personne l'écrivent.
26 types de ressources FHIR R4 sont stockés. Les ressources de facturation telles que Claim et ExplanationOfBenefit ne le sont pas.
Les autres applications lisent l'historique d'une personne uniquement avec le consentement de cette personne ; la clé propre à un projet voit les patients qu'il a créés.

Questions fréquemment posées

Qu'est-ce que les données longitudinales de patients ?

Les informations de santé d'une personne collectées au fil du temps et dans différents contextes de soins — diagnostics, médicaments, résultats, signes vitaux, vaccinations et visites — conservées pour pouvoir être lues comme un historique continu.

Quelle API donne une vue chronologique du dossier d'un patient ?

Dans Anpheros, GET /v1/patients/{id}/timeline renvoie les entrées de huit types de ressources par ordre de date, avec pagination et filtres de date et de type. Pour les données FHIR complètes, utilisez Patient/$everything.

L'historique est-il stocké dans un format standard ?

Oui. Chaque entrée est une ressource HL7 FHIR R4 avec des codes standard (LOINC, ICD-10, ATC, CVX, UCUM), et le résumé est un International Patient Summary.

Comment savoir qui a écrit chaque entrée ?

Chaque écriture crée une ressource Provenance avec le type d'auteur (patient, praticien, appareil, importation ou IA), la personne, l'organisation et le système source.

Puis-je tester avec des données longitudinales réalistes ?

Oui. Chaque projet sandbox commence avec 30 patients synthétiques ayant environ six mois de conditions, médicaments, résultats de laboratoire et signes vitaux.

Liens pertinents

Application de dossier de santé personnel (DSPs) avec FHIR : une chronologie dans une application réelle
Provenance des données médicales expliquée
Plateforme de consentement patient pour les applications de santé
Comment stocker des dossiers médicaux en utilisant FHIR R4
Agents IA et données médicales : le point de terminaison de contexte
Webhooks

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