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

API de santé : qu'est-ce que c'est et comment ça marche

Ce qu'est une API de santé, comment fonctionne un appel, quoi rechercher, et une API de santé FHIR R4 gratuite avec consentement patient, provenance et hébergement UE — avec exemples et FAQ.

Une API de santé est une interface programmatique par laquelle un logiciel lit et écrit des données de santé — dossiers patients, observations, diagnostics, médicaments, documents — et par laquelle l'accès à ces données est autorisé. L'API de la plateforme Anpheros est une API de santé sur un dossier HL7 FHIR R4 contrôlé par le patient : les applications l'utilisent pour stocker et récupérer des données médicales, pour obtenir le consentement d'un patient et pour être notifiées des changements.

Comment fonctionne un appel d'API de santé

Quel que soit le fournisseur, un appel d'API de santé passe par les mêmes points de contrôle : qui appelle, quel patient et quelles données il peut consulter, où les données sont stockées, qui les a écrites et qui a besoin de savoir qu'elles ont changé.

Types d'API de santé

Anpheros combine les deux premiers comme son cœur, accepte les résultats de laboratoire HL7 v2 en entrée, stocke les documents avec leurs originaux et produit des bundles de documents FHIR (le Résumé International du Patient). Il offre également une API REST plus simple sur les mêmes données pour les développeurs qui ne souhaitent pas travailler directement avec FHIR.

Ce qu'il faut rechercher dans une API de santé

Le reste de cette page montre comment chacun de ces éléments apparaît dans l'API Anpheros.

L'API Anpheros en un coup d'œil

URL de base : https://platform.anpheros.com. Le sandbox et la production partagent la même URL ; la clé décide du plan de données.

Authentification

• Clés API (sk_test_…, sk_live_…) pour vos serveurs ; elles voient les patients créés par votre projet.
• Jetons d'accès OAuth (at_…) pour une application agissant pour un patient sous un consentement.

curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"

Écriture sécurisée

Les requêtes POST acceptent un Idempotency-Key : une requête retentée avec la même clé renvoie la réponse originale et ne crée rien. Chaque écriture reçoit un Provenance ; le type d'auteur est envoyé dans le corps (author_type) ou dans des en-têtes tels que X-Anpheros-Author-Type, X-Anpheros-Source-System, X-Anpheros-Origin-Id et X-Anpheros-On-Behalf-Of.

curl -X POST https://platform.anpheros.com/v1/patients/$PID/observations \
     -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" \
     -d '{"code": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'

Erreurs et limites

Les points d'accès FHIR répondent avec OperationOutcome ; les autres avec {"error": {"type", "message", "field"}}. Chaque réponse contient Anpheros-Request-Id. La limite par défaut est de 600 requêtes par minute par clé et par IP. Erreurs · Limites

Événements

Webhooks signés pour resource.created, resource.updated, resource.deleted, consent.granted, consent.revoked, document.finalized et ping. Webhooks

Choisir entre FHIR et REST v1

Utilisez FHIR si vous travaillez déjà avec FHIR, si vous avez besoin de types de ressources que /v1 ne couvre pas (par exemple Immunization, Procedure ou CarePlan), ou si vous échangez des données avec d'autres systèmes FHIR. Utilisez REST v1 pour le code d'application qui souhaite un JSON plat pour les cas courants. Les deux lisent et écrivent les mêmes ressources avec les mêmes identifiants, donc un projet peut les mélanger. Medical data API décrit les opérations de données en détail.

Foire aux questions

Qu'est-ce qu'une API de santé ?

Une interface programmatique par laquelle les logiciels lisent et écrivent des données de santé — dossiers patients, observations, diagnostics, médicaments et documents — et par laquelle l'accès à ces données est autorisé. Les API de santé modernes utilisent HL7 FHIR R4 pour les données et OAuth 2.0 ou 2.1 avec SMART on FHIR pour l'autorisation.

Quelle est la différence entre une API de santé et une API FHIR ?

FHIR est une norme qu'une API de santé peut suivre. Une API FHIR échange des ressources FHIR sur REST ; une API de santé peut également accepter des messages HL7 v2, des documents ou du JSON propriétaire. Anpheros propose une API FHIR R4 et une API REST plus simple sur les mêmes données.

Existe-t-il une API de santé gratuite pour les développeurs ?

Oui. Le sandbox Anpheros est gratuit et en libre-service : connectez-vous avec Google, obtenez une clé API et travaillez avec 30 patients synthétiques via FHIR R4 ou REST. La production commence à 99 € par mois, avec le premier mois gratuit.

Comment les patients donnent-ils leur consentement à une API de santé ?

Via OAuth 2.1 avec PKCE : l'application redirige la personne vers une page de consentement avec des scopes SMART on FHIR ; la personne choisit ce qu'elle souhaite partager et pour combien de temps, peut consulter un journal d'accès et peut révoquer l'accès à tout moment.

Où sont stockées les données ?

Dans l'Union européenne : le service et ses bases de données s'exécutent sur Google Cloud europe-west4 (Pays-Bas).

Quelle API de santé devrais-je choisir ?

Comparez la norme de données, qui autorise l'accès, la provenance et l'audit, la résidence des données, le comportement des nouvelles tentatives et des erreurs, et si vous pouvez tester avec des données réalistes gratuitement. Plateforme d'API de santé : ce qu'elle inclut et comment choisir transforme ces éléments en questions à poser à tout fournisseur.

Liens connexes

• API EHR et API de dossiers médicaux
• Plateforme d'API de santé : ce qu'elle inclut et comment choisir
• Comment créer une API de santé avec TypeScript : tutoriel étape par étape avec Express
• Comment stocker des dossiers médicaux en utilisant FHIR R4 : tutoriel étape par étape avec curl
• API de santé avec consentement du patient
• Backend SMART on FHIR
• API de données médicales
• Plateforme FHIR
• Interopérabilité des données de santé
• Intégrations de santé
• Référence API (OpenAPI) · Authentification et OAuth

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