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

API de données médicales

Où vont les différents types de données médicales dans l'API Anpheros, comment elles sont codées, et comment les écrire, filtrer, tracer, corriger et supprimer — avec exemples fonctionnels.

Une API de données médicales donne aux logiciels un accès structuré au contenu des dossiers patients : créer un patient, enregistrer une mesure de tension artérielle, lister les médicaments actifs, joindre un rapport de laboratoire, tracer qui a écrit quoi. Cette page décrit les opérations de données de l'API Anpheros — où se situe chaque type de données médicales, comment il est codé, et comment le lire — avec des exemples qui fonctionnent contre le sandbox.

Les applications utilisent ces opérations pour traiter Anpheros comme la base de données médicale de leur produit : les dossiers patients résident dans le magasin HL7 FHIR R4 de la plateforme, et l'application les lit et les écrit via l'API au lieu de conserver ses propres tables de données médicales.

Pour une vue d'ensemble plus large (authentification, consentement, événements), consultez API de santé.

Où vont les différents types de données médicales

Les objets REST v1 et les ressources FHIR sont les mêmes enregistrements avec les mêmes identifiants ; chaque objet v1 porte sa référence fhir.

Écrire des données médicales

# a lab result with its reference range, linked to the report it came from
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": "4548-4", "display": "Hemoglobin A1c", "category": "laboratory",
  "value": 6.4, "unit": "%", "effective_at": "2026-09-01T08:00:00Z",
  "reference_range": {"low": 4.0, "high": 5.6},
  "derived_from": ["DocumentReference/'$DOC'"], "author_type": "import"
}'

• Catégories d'observation : vital-signs, laboratory, symptom, activity, survey, exam, imaging, social-history.
• Mesures composites telles que la pression artérielle utilisent components (systolique 8480-6, diastolique 8462-4 à l'intérieur du panel 85354-9).
• Types d'auteurs : patient, practitioner, device, import, ai. Sans l'un d'eux, la plateforme enregistre import.
• Codes que vous ne connaissez pas par cœur : GET /v1/terminology/loinc?q=hba1c recherche le sous-ensemble LOINC inclus et GET /v1/search?q=metformin le catalogue des symptômes, conditions et médicaments ; une observation écrite sans nom d'affichage obtient automatiquement le nom LOINC.

Lecture des données médicales

curl "https://platform.anpheros.com/v1/patients/$PID/observations?category=laboratory&code=4548-4&from=2026-01-01" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/conditions?clinical_status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

Les listes sont paginées avec limit et cursor. La timeline fusionne les observations, les conditions, les médicaments, les documents, les visites, les rendez-vous, les vaccinations et les épisodes de soins en une seule liste chronologique — l'entrée naturelle pour un écran d'historique du patient.

Pour tout ce que les filtres REST ne couvrent pas, utilisez la recherche FHIR : GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date (plateforme FHIR).

Traçage et correction des données

• Qui l'a écrit : GET /v1/patients/{id}/provenance/{type}/{resourceId} — une entrée par version, avec le type d'auteur, le projet, l'organisation et le système source.
• Chaque version : GET /fhir/R4/{type}/{id}/_history ; mettez à jour avec If-Match pour éviter d'écraser la modification de quelqu'un d'autre.
• Propriété : avec consentement, vous pouvez lire ce que d'autres organisations ont écrit, mais modifier ou supprimer uniquement ce que votre projet a écrit (403 sinon).
• Suppression : DELETE /v1/{observations|conditions|medications}/{id} ; la suppression d'un Patient supprime l'intégralité de l'enregistrement.

Documents

Créez le document (vous obtenez une cible de téléchargement), téléchargez les octets via la plateforme ou directement vers le stockage, puis finalisez. Après la finalisation, l'original est immuable ; son SHA-256 et sa taille sont enregistrés. Jusqu'à 25 MiB par fichier.

Liens connexes

• Comment normaliser les données médicales : codes, unités, dates, doublons, validation
• Provenance des données médicales expliquée : qui a écrit quoi, et comment l'enregistrer
• API de santé
• Dossier médical du patient
• Créer une application de santé
• Référence API (OpenAPI) · Démarrage rapide

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