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

Comment stocker des dossiers médicaux avec FHIR R4

Q: Comment stocker la tension artérielle dans FHIR ?

Comme une Observation avec le code LOINC 85354-9 et deux entrées component : systolique 8480-6 et diastolique 8462-4, chacune avec une valueQuantity en mm[Hg].

Q: Puis-je modifier une ressource stockée ?

Oui, avec PUT et If-Match. Chaque modification crée une nouvelle version ; les versions antérieures restent lisibles via _history, et les enregistrements de Provenance indiquent qui a effectué chaque modification. Les suppressions sont douces et conservent l'historique.

Tutoriel : créer un Patient, une Observation de tension artérielle et une Condition, utiliser une transaction, rechercher, mettre à jour avec l'historique et lire la provenance — chaque requête avec curl et la réponse réelle, sur la sandbox gratuite.

Ce tutoriel stocke un petit dossier médical sous forme de ressources HL7 FHIR R4 : un Patient, une Observation de tension artérielle et un diagnostic sous forme de Condition, puis un patient et une mesure ensemble dans une seule transaction. Il les recherche, met à jour le diagnostic sans perdre la version précédente et lit qui a écrit quoi. Chaque requête est en curl brut contre le bac à sable Anpheros gratuit, et chaque réponse affichée est ce que l'API renvoie.

Si vous débutez avec FHIR, lisez d'abord Plateforme FHIR pour les concepts. Cette page est la partie pratique.

Les trois ressources avec lesquelles la plupart des dossiers commencent

Ressource	Ce qu'elle contient	Codé avec
`Patient`	la personne concernée par le dossier : nom, date de naissance, genre, identifiants d'autres systèmes	vos systèmes d'identification
`Observation`	tout ce qui est mesuré ou rapporté : signes vitaux, résultats de laboratoire, un poids, un score de symptôme	LOINC, unités UCUM
`Condition`	un diagnostic ou un problème de santé, avec son statut au fil du temps	ICD-10 (SNOMED CT derrière un drapeau de licence)

Les médicaments (MedicationStatement), les allergies (AllergyIntolerance), les immunisations et les documents suivent le même schéma ; les 26 types de ressources pris en charge sont listés dans la déclaration de capacité à /fhir/R4/metadata.

Avant de commencer

Obtenez une clé sandbox (sk_test_…) sur platform.anpheros.com/dashboard en cliquant sur Get a sandbox key. Rien de ce que vous créez ici ne correspond à de véritables données de patients, et rien n'est visible par d'autres projets.

export BASE=https://platform.anpheros.com/fhir/R4
export KEY=sk_test_…

Étape 1 : créer un Patient

curl -X POST "$BASE/Patient" -H "Authorization: Bearer $KEY" -H "Content-Type: application/fhir+json" -d '{
  "resourceType": "Patient",
  "identifier": [{"system": "https://clinic.example/mrn", "value": "MRN-10442"}],
  "name": [{"family": "Marin", "given": ["Ioana"]}],
  "gender": "female",
  "birthDate": "1979-04-12"
}'

201 Created, avec l'id et la version attribués par le serveur :

{"resourceType": "Patient",
 "identifier": [{"system": "https://clinic.example/mrn", "value": "MRN-10442"}],
 "name": [{"family": "Marin", "given": ["Ioana"]}], "gender": "female", "birthDate": "1979-04-12",
 "id": "d09e3942-ed86-4458-b099-fa674ab21b84",
 "meta": {"versionId": "1", "lastUpdated": "2026-10-12T20:16:51.043Z"}}

Conservez vos propres identifiants dans identifier avec un system que vous contrôlez (ici un numéro de dossier de clinique), afin de pouvoir toujours retrouver le patient avec GET $BASE/Patient?identifier=https://clinic.example/mrn|MRN-10442. Le id FHIR est celui de la plateforme, et il est spécifique à votre projet : un autre projet verra la même personne sous un id différent.

export PID=d09e3942-ed86-4458-b099-fa674ab21b84

Étape 2 : stocker une mesure en tant qu'Observation

La pression artérielle est une observation comportant deux composantes, systolique et diastolique, chacune avec son propre code LOINC. Indiquez qui l'a mesurée : ici, un appareil domestique.

curl -X POST "$BASE/Observation" -H "Authorization: Bearer $KEY" -H "Content-Type: application/fhir+json" \
     -H "X-Anpheros-Author-Type: device" -H "Idempotency-Key: bp-2026-10-10-0830" -d '{
  "resourceType": "Observation",
  "status": "final",
  "category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "vital-signs"}]}],
  "code": {"coding": [{"system": "http://loinc.org", "code": "85354-9", "display": "Blood pressure panel"}]},
  "subject": {"reference": "Patient/'$PID'"},
  "effectiveDateTime": "2026-10-10T08:30:00Z",
  "component": [
    {"code": {"coding": [{"system": "http://loinc.org", "code": "8480-6"}]},
     "valueQuantity": {"value": 138, "unit": "mmHg", "system": "http://unitsofmeasure.org", "code": "mm[Hg]"}},
    {"code": {"coding": [{"system": "http://loinc.org", "code": "8462-4"}]},
     "valueQuantity": {"value": 88, "unit": "mmHg", "system": "http://unitsofmeasure.org", "code": "mm[Hg]"}}
  ]
}'

La réponse est la ressource stockée avec id et meta.versionId: "1". Trois détails sont importants pour un enregistrement utilisable :

Codes, pas des libellés. 85354-9 signifie "panel de pression artérielle" dans tous les systèmes FHIR ; un texte libre "BP" ne le fait pas. Recherchez les codes avec GET /v1/terminology/loinc?q=blood pressure (Systèmes de codes FHIR).
Unités UCUM (mm[Hg], kg, mg/dL) dans valueQuantity.code, afin que les valeurs puissent être comparées et converties.
Idempotency-Key. Une nouvelle tentative après un délai d'attente renvoie la première réponse au lieu de stocker la mesure deux fois.

Les résultats de laboratoire sont la même ressource avec category laboratory et généralement un referenceRange. Pour intégrer des rapports de laboratoire complets, consultez Comment importer des résultats de laboratoire dans un enregistrement FHIR.

Étape 3 : enregistrer un diagnostic en tant que Condition

curl -X POST "$BASE/Condition" -H "Authorization: Bearer $KEY" -H "Content-Type: application/fhir+json" \
     -H "X-Anpheros-Author-Type: practitioner" -d '{
  "resourceType": "Condition",
  "subject": {"reference": "Patient/'$PID'"},
  "clinicalStatus": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/condition-clinical", "code": "active"}]},
  "verificationStatus": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/condition-ver-status", "code": "confirmed"}]},
  "code": {"coding": [{"system": "http://hl7.org/fhir/sid/icd-10", "code": "I10", "display": "Essential (primary) hypertension"}]},
  "onsetDateTime": "2026-03-02"
}'

clinicalStatus (active, resolved, in remission) et verificationStatus (confirmed, provisional) sont séparés intentionnellement : un diagnostic suspecté n'est pas la même chose qu'un diagnostic confirmé, et un problème résolu fait toujours partie de l'historique.

Étape 4 : créer des ressources associées en une seule transaction

Lorsque qu'un patient et sa première mesure arrivent ensemble, par exemple depuis un système de clinique, envoyez-les dans un transaction Bundle. Soit tout est stocké, soit rien ne l'est. Les références entre les nouvelles ressources utilisent des urn:uuid: ids temporaires que le serveur remplace :

curl -X POST "$BASE" -H "Authorization: Bearer $KEY" -H "Content-Type: application/fhir+json" -d '{
  "resourceType": "Bundle", "type": "transaction",
  "entry": [
    {"fullUrl": "urn:uuid:9f1c0d1e-0000-4000-8000-000000000001",
     "resource": {"resourceType": "Patient", "name": [{"family": "Stan", "given": ["Mihai"]}], "gender": "male", "birthDate": "1990-02-01"},
     "request": {"method": "POST", "url": "Patient"}},
    {"resource": {"resourceType": "Observation", "status": "final",
       "category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "vital-signs"}]}],
       "code": {"coding": [{"system": "http://loinc.org", "code": "29463-7", "display": "Body weight"}]},
       "subject": {"reference": "urn:uuid:9f1c0d1e-0000-4000-8000-000000000001"},
       "effectiveDateTime": "2026-10-10",
       "valueQuantity": {"value": 82.4, "unit": "kg", "system": "http://unitsofmeasure.org", "code": "kg"}},
     "request": {"method": "POST", "url": "Observation"}}
  ]
}'

Le transaction-response a une entrée par ressource, avec "status": "201 Created", son location et la ressource stockée. Le subject de l'Observation pointe maintenant vers le vrai Patient/fad3665a-….

Étape 5 : recherche

curl "$BASE/Observation?patient=$PID&code=http://loinc.org|85354-9&date=ge2026-10-01&_sort=-date" \
     -H "Authorization: Bearer $KEY"

Vous obtenez un searchset Bundle avec total et les ressources correspondantes, les plus récentes en premier. Autres recherches que vous utiliserez souvent : Condition?patient=$PID&clinical-status=active, Observation?patient=$PID&category=laboratory et Patient/$PID/$everything pour l'ensemble du dossier.

Étape 6 : mise à jour sans perte d'historique

L'hypertension se résout. Modifiez le statut et ajoutez la date de fin, et utilisez If-Match avec la version que vous avez lue pour ne jamais écraser la modification de quelqu'un d'autre :

curl -X PUT "$BASE/Condition/$CID" -H "Authorization: Bearer $KEY" -H "Content-Type: application/fhir+json" \
     -H 'If-Match: W/"1"' -d '{ …the same Condition…, "clinicalStatus": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/condition-clinical", "code": "resolved"}]}, "abatementDateTime": "2026-10-11" }'

200 OK avec ETag: W/"2". Si une autre écriture est arrivée avant, vous obtenez 412 et relisez. La version précédente est toujours là :

curl "$BASE/Condition/$CID/_history" -H "Authorization: Bearer $KEY"

renvoie les deux versions : versionId 2 (resolved) et 1 (active). GET $BASE/Condition/$CID/_history/1 lit l'ancienne. Rien dans un enregistrement n'est écrasé silencieusement.

Étape 7 : voir qui a écrit quoi

Chaque écriture crée une ressource Provenance. Pour la mesure de la pression artérielle :

curl "$BASE/Provenance?target=Observation/$OBS" -H "Authorization: Bearer $KEY"

{"resourceType": "Provenance",
 "target": [{"reference": "Observation/d83d9075-…/_history/1"}],
 "recorded": "2026-10-12T20:16:51.056000Z",
 "activity": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v3-DataOperation", "code": "CREATE"}]},
 "agent": [{"type": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type", "code": "author"}]},
            "who": {"identifier": {"system": "https://anpheros.com/fhir/CodeSystem/author-type", "value": "device"}, "display": "proj_…"},
            "onBehalfOf": {"identifier": {"system": "https://anpheros.com/fhir/sid/organization", "value": "org_…"}, "display": "…"}}]}

Le type d'auteur que vous avez envoyé (device) est enregistré avec le projet et l'organisation. Envoyez X-Anpheros-Author-Ref: Practitioner/<id> pour nommer le clinicien derrière une écriture.

Étape 8 : le dossier comme résumé

curl "$BASE/Patient/$PID/\$summary" -H "Authorization: Bearer $KEY"

renvoie un International Patient Summary : un document Bundle qui commence par un Composition et contient des sections telles que Problèmes, Médicaments, Allergies et Signes vitaux, construits à partir des ressources ci-dessus. C'est le format à transmettre à un autre système ou à imprimer pour un médecin (Plateforme FHIR).

Vous préférez JSON sans FHIR ?

Les mêmes données sont disponibles via une vue REST plus simple, /v1, avec les mêmes identifiants : POST /v1/patients/{id}/observations prend {"code": "85354-9", "category": "vital-signs", "effective_at": "…", "components": […]} et stocke la même Observation FHIR. Utilisez celle qui convient le mieux à votre code. Voir API de données médicales et les SDK.

Foire aux questions

Quelle est la meilleure façon de stocker des dossiers médicaux ?

Tel qu'encodées, des ressources versionnées avec un enregistrement de qui a écrit chacune d'elles. HL7 FHIR R4 vous donne la structure (Patient, Observation, Condition et autres), des systèmes de codage standard tels que LOINC et ICD-10, et l'historique ; un backend FHIR ajoute la recherche, le consentement et la provenance par-dessus.

Ai-je besoin d'un serveur FHIR pour utiliser FHIR ?

Vous avez besoin d'un endroit qui stocke et recherche des ressources FHIR et qui applique qui peut les lire. Vous pouvez exécuter vous-même un serveur FHIR open-source ou utiliser un serveur géré tel qu'Anpheros ; Comment Anpheros se compare aux autres serveurs FHIR pèse les options, et FHIR vs une base de données médicale personnalisée couvre la création de votre propre schéma à la place.

Comment stocker la tension artérielle dans FHIR ?

Comme une Observation avec le code LOINC 85354-9 et deux entrées component : systolique 8480-6 et diastolique 8462-4, chacune avec une valueQuantity en mm[Hg].

Puis-je modifier une ressource stockée ?

Oui, avec PUT et If-Match. Chaque modification crée une nouvelle version ; les versions antérieures restent lisibles via _history, et les enregistrements de Provenance indiquent qui a effectué chaque modification. Les suppressions sont douces et conservent l'historique.

Liens utiles

Plateforme FHIR : concepts, types de ressources et opérations
Systèmes de codes FHIR : LOINC, ICD-10, ATC, UCUM
Comment importer des résultats de laboratoire dans un enregistrement FHIR
API de données médicales : la vue REST simplifiée des mêmes données
Base de données et bac à sable FHIR gratuits

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