# Intégrations de santé

> Modèles d'intégration pris en charge aujourd'hui : rapports de laboratoire en un seul appel, cliniques écrivant au nom d'une organisation, appareils, applications tierces consenties, webhooks et SDK — et ce qui n'est pas disponible.

Source: https://developers.anpheros.com/fr/guides/healthcare-integrations

**Une intégration de santé connecte un système qui produit ou a besoin de données de santé — un laboratoire, une clinique, un appareil, une autre application — au dossier du patient.** Avec Anpheros, chaque intégration passe par la même API et les mêmes règles : les données sont écrites en HL7 FHIR R4, attribuées à leur source, visibles par le patient, et partagées avec d'autres parties uniquement avec le consentement du patient. Cette page décrit les modèles d'intégration que la plateforme prend en charge aujourd'hui.

[Explorez le répertoire d'intégrations Anpheros](https://anpheros.com/integrations) pour voir chaque intégration avec son statut vérifié (disponible, bêta ou guide développeur), les données et les ressources FHIR qu'elle échange, sa direction, son authentification et sa documentation.

## Laboratoires : rapports complets en un seul appel

Un laboratoire, ou tout système détenant des rapports de laboratoire, envoie un rapport complet et la plateforme transforme chaque résultat en un laboratoire `Observation` :

```bash
curl -X POST https://platform.anpheros.com/v1/patients/$PID/labs/import \
     -H "Authorization: Bearer $KEY" -H "Content-Type: text/csv" \
     -H "X-Anpheros-Source-System: labx" -H "Idempotency-Key: report-2026-0917-77" \
     --data-binary @report.csv
```

- Formats : **CSV** (en-têtes roumains ou anglais, virgule décimale acceptée), **HL7 v2 ORU^R01** et **JSON**.
- Les marqueurs sont mappés sur **LOINC** lorsque le rapport fournit un code ou que le nom correspond à la terminologie de la plateforme ; les autres conservent le code propre au laboratoire et sont listés comme `unmapped`.
- Chaque ligne reçoit un identifiant stable, ainsi le **ré-envoi du même rapport ignore ce qui a déjà été importé**.
- Jusqu'à 500 lignes par requête ; chaque résultat porte une provenance nommant le système source et le rapport.

Détails : [Connecteur de laboratoire](https://developers.anpheros.com/fr/guides/lab-connector).

## Cliniques : écrire au nom d'une organisation

Les cliniques et les personnes qui y travaillent sont des ressources d'annuaire (`Organization`, `Practitioner`, `PractitionerRole`). Le système d'une clinique peut alors indiquer qui est à l'origine de chaque requête :

- `X-Anpheros-Acting-As: PractitionerRole/<id>` — le praticien travaillant via votre application ; écrit dans le journal d'accès et affiché au patient par son nom ;
- `X-Anpheros-On-Behalf-Of: Organization/<id>` — l'organisation pour laquelle une écriture est effectuée ;
- `X-Anpheros-Author-Ref: Practitioner/<id>` — l'auteur enregistré dans `Provenance`.

Avec le consentement du patient, la clinique lit l'intégralité du dossier, y compris ce qu'ont écrit d'autres organisations, et ne modifie que ce qu'elle a écrit elle-même. Plusieurs ressources peuvent être écrites atomiquement avec un bundle FHIR `transaction` (`POST /fhir/R4`).

Un exemple concret, de l'annuaire à une visite écrite en une seule transaction : [Comment intégrer les systèmes de clinique avec un backend FHIR](https://developers.anpheros.com/fr/guides/integrate-clinic-systems-fhir).

Le flux consentement → laboratoire `Observation` écrit par un projet de clinique → notification dans l'application du patient a été exercé de bout en bout avec un projet de clinique de test.

## Appareils et dispositifs portables

Les mesures provenant des appareils sont des `Observation`s avec `author_type: "device"` et un code LOINC — fréquence cardiaque, tension artérielle, SpO₂, poids, glycémie, pas, durée du sommeil et autres ([Systèmes de codes FHIR](https://developers.anpheros.com/fr/guides/fhir-code-systems)). Anpheros Daily écrit les résumés quotidiens qu'il lit d'Apple Health et de Health Connect sous forme d'Observations de la même manière. Anpheros ne se connecte pas directement aux clouds des fournisseurs d'appareils ; votre application ou votre backend lit l'appareil et écrit le résultat. Comment lire Apple Health, Health Connect et Samsung Health et mapper chaque métrique à LOINC : [Données des appareils portables en FHIR](https://developers.anpheros.com/fr/guides/wearable-data-fhir).

## Applications tierces : accès consenti

Une application qui souhaite accéder à des données qu'une personne conserve déjà dans Anpheros s'enregistre une fois et demande le consentement via OAuth 2.1 avec PKCE (lancement autonome SMART on FHIR) :

1. `GET /oauth/authorize?...&scope=patient/Observation.rs?category=laboratory offline_access` — la page de consentement hébergée ;
2. la personne choisit le dossier et la durée (30, 90, 180 ou 365 jours) ;
3. `POST /oauth/token` échange le code contre un jeton d'accès (30 minutes) et un jeton de rafraîchissement rotatif (30 jours) ;
4. l'application ne voit que ce patient, uniquement dans ses scopes, sous son propre identifiant par paire.

[Authentification et OAuth](https://developers.anpheros.com/fr/guides/authentication)

## Événements : réagir aux changements

Au lieu d'interroger, enregistrez un webhook. Les livraisons sont signées avec HMAC-SHA256, retentées avec backoff pendant 24 heures maximum et portent des identifiants, jamais de contenu clinique. Lorsqu'un autre projet écrit dans un enregistrement auquel vous avez accès, l'événement l'indique (`data.external: true`, avec la source). [Webhooks](https://developers.anpheros.com/fr/guides/webhooks)

## SDKs

Les SDK TypeScript (`@anpheros/sdk`) et Dart / Flutter (`anpheros_sdk`) implémentent tout ce qui précède : importation de laboratoire (`labs.importCsv`, `labs.importHl7`, `labs.importItems`), OAuth avec PKCE, gestion des webhooks et vérification de signature. [SDKs](https://developers.anpheros.com/fr/guides/sdks)

## Ce qui n'est pas disponible

- Connecteurs prêts à l'emploi pour des systèmes EHR hospitaliers ou des systèmes d'information de laboratoire spécifiques ; les intégrations sont construites contre l'API.
- Lancement SMART EHR (lancement à l'intérieur d'un EHR) ; seul le lancement autonome est pris en charge.
- Intégrations directes avec les fournisseurs d'appareils.

## Liens Utiles

- [Comment intégrer les systèmes de clinique avec un backend FHIR](https://developers.anpheros.com/fr/guides/integrate-clinic-systems-fhir) : tutoriel étape par étape pour les DME de clinique
- [Comment normaliser les données médicales](https://developers.anpheros.com/fr/guides/normalize-medical-data) : codes, unités, dates, doublons, validation
- [Comment importer les résultats de laboratoire dans un enregistrement FHIR](https://developers.anpheros.com/fr/guides/import-lab-results-fhir) : tutoriel étape par étape avec CSV et HL7 v2
- [Interopérabilité des données de santé](https://developers.anpheros.com/fr/guides/interoperability)
- [API de santé](https://developers.anpheros.com/fr/guides/healthcare-api)
- [Architecture](https://developers.anpheros.com/fr/guides/architecture)
- [Cas d'utilisation](https://developers.anpheros.com/fr/guides/use-cases)
