# API de données longitudinales du patient

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

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

**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.

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

## 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

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

## 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 :

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

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

```bash
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.

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

## Liens pertinents

- [Application de dossier de santé personnel (DSPs) avec FHIR](https://developers.anpheros.com/fr/guides/personal-health-record-app) : une chronologie dans une application réelle
- [Provenance des données médicales expliquée](https://developers.anpheros.com/fr/guides/medical-data-provenance)
- [Plateforme de consentement patient pour les applications de santé](https://developers.anpheros.com/fr/guides/patient-consent-platform)
- [Comment stocker des dossiers médicaux en utilisant FHIR R4](https://developers.anpheros.com/fr/guides/store-medical-records-fhir)
- [Agents IA et données médicales](https://developers.anpheros.com/fr/guides/ai-agents-medical-data) : le point de terminaison de contexte
- [Webhooks](https://developers.anpheros.com/fr/guides/webhooks)