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

API pro data symptomů: koncepty, FHIR terminologie a symptomy hlášené pacientem

Stabilní identifikátory symptomů mapované na ICD-10, podávané jako REST a jako FHIR CodeSystem, ValueSet a ConceptMap; jak vypadá symptom hlášený pacientem v Observation a jak jej validovat.

Anpheros přiřazuje každému symptomu stabilní identifikátor (SYM-0047 je bolest hlavy), mapuje jej na ICD-10 a seznam zpřístupňuje prostřednictvím koncového bodu REST a jako terminologii FHIR R4 (CodeSystem, ValueSet, ConceptMap, $lookup). Symptomy, které pacienti hlásí, jsou ukládány jako FHIR Observations, které nesou oba kódy, vlastní slova osoby, intenzitu a, pokud je známo, kdy symptom začal a skončil. Tato stránka ukazuje, jak najít koncept, jak vypadá symptom hlášený pacientem, jak zkontrolovat ten, který si sami napíšete, a co data záměrně neobsahují.

Co je v této verzi

Identifikátory se nikdy znovu nepoužívají. Koncept, který je stažen, zůstává v seznamu s status: deprecated.

Najít koncept (REST)

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

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

q odpovídá ID konceptu, kódům ICD-10 a ICD-11, štítkům a shodným termínům. Další parametry: icd10=R51 (koncept pro jeden kód), icd11=MB4D, body_system=nervous, kind=symptom|finding|all, lang=de (jazyk display: preferovaný štítek, jinak běžný štítek, jinak angličtina), limit a 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 uvádí každý obsluhovaný štítek (20 jazyků; zde zkráceno). Jeden koncept: GET $API/terminology/symptoms/SYM-0047.

Stejný seznam jako 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 (vydání nebylo zkontrolováno klinickým lékařem); vlastnosti kind, status, icd10; rumunské popisky, shodné termíny a laické popisky jako designation.
• ValueSet/anpheros-symptoms — aktivní symptomy (nálezy vyloučeny); $expand přebírá filter, displayLanguage, count a offset.
• ConceptMap/anpheros-symptom-to-icd10 — equivalent, nebo wider, když kód ICD-10 pokrývá více než koncept (H53.8 „Jiné zrakové poruchy“ je širší než rozmazané vidění).
• Všechny jsou pouze pro čtení a uvedeny v CapabilityStatement serveru (GET $BASE/metadata).

Pacientem nahlášený symptom

Takto Anpheros Daily zaznamenává symptom, který osoba nahlásila jako přítomný, týkající se jí samotné:

{
  "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 jsou vždy vlastní slova osoby, v jejím jazyce (Observation.language); kódy jsou uvedeny vedle nich.
• effectivePeriod se používá, když osoba uvedla, kdy symptom začal nebo skončil; jinak effectiveDateTime je okamžik, kdy jej zaznamenala. Časy si zachovávají offset telefonu, který je zaznamenal.
• valueQuantity je intenzita na škále 1–10; bez ní není hodnota.
• Když osoba upraví symptom, stejný zdroj dostane novou verzi — starší verze se čtou pomocí GET $BASE/Observation/{id}/_history.
• Filtrujte podle kategorie pomocí ?category=symptom; rozsahy souhlasu, jako je patient/Observation.rs?category=symptom, fungují stejně.

Co se nikdy nepublikuje jako symptom

Pouze symptomy, které jsou přítomné a týkají se pacienta, se stávají Observation a pouze poté, co byl volný text normalizován. "Moje hlava už nebolí", "možná zítra horečka", "moje matka má kašel" nebo text, který normalizátor nedokázal přečíst, se nestanou symptomem pacienta; pokud je publikovaný symptom později opraven na jeden z těchto, jeho Observation je stažena (soft delete — historie zůstává). Stížnosti příbuzných se automaticky nepřevádějí na rodinnou anamnézu.

Zkontrolujte zadaný symptom

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

Profil anpheros-symptom (kanonický https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation) hlásí jako OperationOutcome:

Stejně jako ostatní profily, i tento hlásí a neodmítá zápisy. meta.profile, které odešlete, zůstane v uloženém zdroji.

Omezení

• Tato verze nebyla zkontrolována lékařem; používejte ji pro kódování a vyhledávání, nikoli pro lékařská rozhodnutí.
• Varovné příznaky jsou citovány doslovně z veřejně dostupných amerických federálních stránek (CDC: příznaky mrtvice a infarktu; NIDDK: průjem a zácpa) a byly zkontrolovány s těmito stránkami k 15. říjnu 2026. Každá položka obsahuje vlastní nadpis zdroje (context), jeho doporučení (quote), skupinu, na kterou se vztahuje (applies_to), zdroj s licencí a uvedením autora, review: source_verified a poznámku, že se nejedná o diagnózu a nebyla zkontrolována lékařem. Zdroje jsou americké: kde citace uvádí 9-1-1, poznámka dodává, že nouzové číslo v Evropě je 112.
• Žádné příčiny ani asociace stavů nejsou poskytovány: associations zůstává prázdné, dokud lékař položku nezkontroluje. Asociace je vždy "může být spojena s".
• Kódy SNOMED CT jsou uvedeny pouze tam, kde to licence umožňuje (viz FHIR code systems).
• Dřívější pozorování symptomů obdrží kódování konceptu Anpheros při příští aktualizaci.

Související

• Anpheros Symptom Engine: metodologie: jak jsou koncepty přiřazovány, kontrolovány a hodnoceny
• Anpheros Search: jedno vyhledávání napříč symptomy, stavy a léčbami, včetně zdrojů
• FHIR code systems: každý kódový systém pro typ zdroje
• Longitudinal patient data API
• Jak ukládat lékařské záznamy pomocí FHIR R4
• FHIR platform

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