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

API de données de symptômes : concepts, terminologie FHIR et symptômes rapportés par le patient

Identifiants de symptômes stables mappés à ICD-10, servis en REST et en CodeSystem, ValueSet et ConceptMap FHIR ; à quoi ressemble un symptôme rapporté par le patient en tant qu'Observation et comment en valider un.

Anpheros attribue à chaque symptôme un identifiant stable (SYM-0047 est mal de tête), le mappe à ICD-10 et sert la liste via un point de terminaison REST et en tant que terminologie FHIR R4 (CodeSystem, ValueSet, ConceptMap, $lookup). Les symptômes que les patients rapportent sont stockés sous forme d'Observation FHIR qui portent à la fois des codes, les propres mots de la personne, l'intensité et, lorsque connu, quand le symptôme a commencé et s'est terminé. Cette page montre comment trouver un concept, à quoi ressemble un symptôme rapporté par le patient, comment vérifier celui que vous écrivez vous-même, et ce que les données ne contiennent délibérément pas.

Ce conține versiunea

Identificatorii nu sunt niciodată reutilizați. Un concept care este retras rămâne în listă cu status: deprecated.

Trouver un concept (REST)

export API=https://platform.anpheros.com/v1
export KEY=sk_test_…

curl "$API/terminology/symptoms?q=headache" -H "Authorization: Bearer $KEY"

q correspond à l'identifiant du concept, aux codes ICD-10 et ICD-11, aux libellés et aux termes de correspondance. Autres paramètres : icd10=R51 (le concept pour un code), icd11=MB4D, body_system=nervous, kind=symptom|finding|all, lang=de (la langue de display : le libellé préféré, sinon le libellé courant, sinon l'anglais), limit et offset.

{
  "data": [{
    "concept_id": "SYM-0047",
    "system": "https://anpheros.com/fhir/CodeSystem/symptom",
    "kind": "symptom",
    "status": "active",
    "display": "Headache, not elsewhere classified",
    "display_lang": "en",
    "icd10": {"system": "http://hl7.org/fhir/sid/icd-10", "code": "R51", "display": null, "equivalence": "equivalent"},
    "icd11": {"system": "http://id.who.int/icd/release/11/mms", "code": "MB4D", "display": "Headache, not elsewhere classified", "equivalence": "equivalent"},
    "body_system": {"code": "nervous", "display": "Symptoms, signs or clinical findings of the nervous system", "icd11_block": "BlockL1-MB4"},
    "labels": [
      {"lang": "ro", "use": "preferred", "text": "Durere de cap (cefalee)", "review": "in_use"},
      {"lang": "de", "use": "lay", "text": "Kopfschmerzen", "review": "ai_reviewed"}
    ],
    "match_terms": [{"lang": "ro", "text": "durere de cap"}, {"lang": "ro", "text": "cefalee"}],
    "clinical_review": false,
    "release": "2026.10.2"
  }],
  "total": 1,
  "release": "2026.10.2"
}

labels liste tous les libellés servis (20 langues ; abrégé ici). Un concept : GET $API/terminology/symptoms/SYM-0047.

La même liste que la terminologie FHIR

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

curl "$BASE/CodeSystem/anpheros-symptom" -H "Authorization: Bearer $KEY"
curl "$BASE/CodeSystem/\$lookup?system=https://anpheros.com/fhir/CodeSystem/symptom&code=SYM-0047&displayLanguage=ro" -H "Authorization: Bearer $KEY"
curl "$BASE/ValueSet/\$expand?url=https://anpheros.com/fhir/ValueSet/anpheros-symptoms&filter=cough" -H "Authorization: Bearer $KEY"
curl "$BASE/ConceptMap/anpheros-symptom-to-icd10" -H "Authorization: Bearer $KEY"
curl "$BASE/ConceptMap/anpheros-symptom-to-icd11" -H "Authorization: Bearer $KEY"

• CodeSystem/anpheros-symptom — content: complete, status: draft (la version n'a pas été révisée par un clinicien) ; propriétés kind, status, icd10 ; étiquettes roumaines, termes correspondants et étiquettes grand public comme designation.
• ValueSet/anpheros-symptoms — les symptômes actifs (findings exclus) ; $expand prend filter, displayLanguage, count et offset.
• ConceptMap/anpheros-symptom-to-icd10 — equivalent, ou wider lorsque le code ICD-10 couvre plus que le concept (H53.8 "Autres troubles visuels" est plus large que la vision floue).
• Tous sont en lecture seule et listés dans le CapabilityStatement du serveur (GET $BASE/metadata).

Un symptôme rapporté par le patient

Voici comment Anpheros Daily enregistre un symptôme qu'une personne a rapporté comme étant présent, la concernant :

{
  "resourceType": "Observation",
  "status": "final",
  "meta": {"profile": ["https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation"]},
  "category": [{"coding": [{"system": "urn:anpheros:observation-category", "code": "symptom"}]}],
  "code": {
    "text": "Mă doare capul de 3 zile",
    "coding": [
      {"system": "http://hl7.org/fhir/sid/icd-10", "code": "R51"},
      {"system": "https://anpheros.com/fhir/CodeSystem/symptom", "code": "SYM-0047", "display": "Headache"}
    ]
  },
  "subject": {"reference": "Patient/…"},
  "effectivePeriod": {"start": "2026-10-11T08:00:00+03:00", "end": "2026-10-14T18:00:00+03:00"},
  "valueQuantity": {"value": 6, "unit": "1-10", "system": "http://unitsofmeasure.org", "code": "{score}"}
}

• code.text représente toujours les propres mots de la personne, dans sa langue (Observation.language) ; les codes se trouvent à côté.
• effectivePeriod est utilisé lorsque la personne a indiqué quand le symptôme a commencé ou s'est terminé ; sinon, effectiveDateTime représente le moment où elle l'a noté. Les heures conservent le décalage de l'appareil qui les a enregistrées.
• valueQuantity représente l'intensité sur une échelle de 1 à 10 ; en l'absence de cette information, il n'y a pas de valeur.
• Lorsqu'une personne modifie un symptôme, la même ressource reçoit une nouvelle version — lisez les versions précédentes avec GET $BASE/Observation/{id}/_history.
• Filtrez par catégorie avec ?category=symptom ; les scopes de consentement tels que patient/Observation.rs?category=symptom fonctionnent de la même manière.

Ce qui n'est jamais publié comme symptôme

Seuls les symptômes qui sont présents et concernant le patient deviennent des Observations, et ce, uniquement après que le texte libre a été normalisé. "Ma tête ne me fait plus mal", "peut-être de la fièvre demain", "ma mère a une toux" ou un texte que le normaliseur n'a pas pu lire ne deviennent pas un symptôme du patient ; si un symptôme publié est ultérieurement corrigé pour devenir l'un de ceux-ci, son Observation est retirée (suppression logique — l'historique est conservé). Les plaintes des proches ne sont pas automatiquement transformées en antécédents familiaux.

Vérifier un symptôme que vous écrivez

curl -X POST "$BASE/Observation/\$validate?profile=anpheros-symptom" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/fhir+json" -d @symptom.json

Le profil anpheros-symptom (canonique https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation) rapporte, en tant que OperationOutcome :

Comme les autres profils, il rapporte et ne rejette pas les écritures. Un meta.profile que vous envoyez est conservé sur la ressource stockée.

Limites

• La version n'a pas été examinée par un clinicien ; utilisez-la pour le codage et la recherche, pas pour des décisions médicales.
• Les signes d'alerte sont cités mot pour mot à partir de pages fédérales du domaine public américain (CDC : signes d'AVC et de crise cardiaque ; NIDDK : diarrhée et constipation) et ont été vérifiés par rapport à ces pages le 15 octobre 2026. Chaque élément porte l'en-tête propre à la source (context), son conseil (quote), le groupe auquel il s'applique (applies_to), la source avec licence et attribution, review: source_verified et la note qu'il ne s'agit pas d'un diagnostic et qu'il n'a pas été examiné par un clinicien. Les sources sont américaines : là où une citation mentionne le 9-1-1, la note ajoute que le numéro d'urgence en Europe est le 112.
• Aucune cause ou association de conditions n'est fournie : associations reste vide jusqu'à ce qu'un clinicien examine un élément. Une association est toujours "peut être associée à".
• Les codes SNOMED CT sont écrits uniquement lorsque la licence le permet (voir Systèmes de codes FHIR).
• Les Observations de symptômes antérieures reçoivent le codage de concept Anpheros lors de leur prochaine mise à jour.

Liens connexes

• Moteur de symptômes Anpheros : méthodologie : comment les concepts sont assignés, vérifiés et évalués
• Anpheros Search : une recherche unique sur les symptômes, les conditions et les traitements, avec les sources
• Systèmes de codes FHIR : chaque système de codes par type de ressource
• API de données patient longitudinales
• Comment stocker des dossiers médicaux en utilisant FHIR R4
• Plateforme FHIR

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