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

API pre údaje o symptómoch: koncepty, terminológia FHIR a symptómy hlásené pacientom

Stabilné identifikátory symptómov mapované na ICD-10, slúžiace ako REST a ako FHIR CodeSystem, ValueSet a ConceptMap; ako vyzerá symptóm hlásený pacientom Observation a ako ho overiť.

Anpheros dáva každému symptómu stabilný identifikátor (SYM-0047 je bolesť hlavy), namapuje ho na ICD-10 a zoznam poskytuje prostredníctvom REST koncového bodu a ako terminológiu FHIR R4 (CodeSystem, ValueSet, ConceptMap, $lookup). Symptómy, ktoré pacienti hlásia, sú uložené ako FHIR Observation, ktoré nesú oba kódy, vlastné slová osoby, intenzitu a, ak je známe, kedy symptóm začal a skončil. Táto stránka ukazuje, ako nájsť koncept, ako vyzerá symptóm hlásený pacientom, ako skontrolovať ten, ktorý si sami napíšete, a čo dáta zámerne neobsahujú.

Čo je v tejto verzii

Identifikátory sa nikdy nepoužívajú opakovane. Koncept, ktorý je stiahnutý, zostáva v zozname s status: deprecated.

Nájsť koncept (REST)

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

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

q zodpovedá ID konceptu, kódom ICD-10 a ICD-11, štítkom a zodpovedajúcim termínom. Ďalšie parametre: icd10=R51 (koncept pre jeden kód), icd11=MB4D, body_system=nervous, kind=symptom|finding|all, lang=de (jazyk display: preferovaný štítok, inak bežný štítok, inak 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ádza každý obsluhovaný štítok (20 jazykov; tu skrátené). Jeden koncept: GET $API/terminology/symptoms/SYM-0047.

Rovnaký zoznam ako terminológia 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 (verzia nebola skontrolovaná klinickým lekárom); vlastnosti kind, status, icd10; rumunské štítky, zodpovedajúce termíny a bežné označenia ako designation.
• ValueSet/anpheros-symptoms — aktívne symptómy (nálezy vylúčené); $expand preberá filter, displayLanguage, count a offset.
• ConceptMap/anpheros-symptom-to-icd10 — equivalent, alebo wider, keď kód ICD-10 pokrýva viac ako koncept (H53.8 "Iné zrakové poruchy" je širší ako rozmazané videnie).
• Všetky sú iba na čítanie a uvedené v CapabilityStatement (GET $BASE/metadata) servera.

Pacientom hlásený symptóm

Takto Anpheros Daily zapisuje symptóm, ktorý osoba nahlásila ako prítomný, o sebe:

{
  "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 sú vždy vlastné slová osoby v jej jazyku (Observation.language); kódy sú vedľa nich.
• effectivePeriod sa používa, keď osoba uviedla, kedy symptóm začal alebo skončil; inak effectiveDateTime je moment, kedy si ho zaznamenala. Časy si zachovávajú offset telefónu, ktorý ich zaznamenal.
• valueQuantity je intenzita na stupnici 1–10; bez nej nie je hodnota.
• Keď osoba upraví symptóm, rovnaký zdroj dostane novú verziu — staršie verzie si prečítate pomocou GET $BASE/Observation/{id}/_history.
• Filtrujte podľa kategórie pomocou ?category=symptom; rozsahy súhlasu, ako napríklad patient/Observation.rs?category=symptom, fungujú rovnako.

Čo sa nikdy nezverejňuje ako symptóm

Iba symptómy, ktoré sú prítomné a týkajú sa pacienta, sa stávajú Observáciami, a to až po normalizácii voľného textu. "Moja hlava už nebolí", "možno zajtra horúčka", "moja matka má kašeľ" alebo text, ktorý normalizátor nedokázal prečítať, sa nestanú symptómom pacienta; ak je zverejnený symptóm neskôr opravený na jeden z týchto, jeho Observácia sa stiahne (soft delete — história zostáva). Sťažnosti príbuzných sa automaticky nepremenia na rodinnú anamnézu.

Skontrolujte príznak, ktorý zadáte

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ási ako OperationOutcome:

Rovnako ako ostatné profily, hlási a neodmieta zápisy. meta.profile, ktorý odošlete, sa uchová v uloženom zdroji.

Limity

• Vydanie nebolo skontrolované klinickým lekárom; používajte ho na kódovanie a vyhľadávanie, nie na lekárske rozhodnutia.
• Varovné príznaky sú citované slovo od slova z verejne dostupných amerických federálnych stránok (CDC: príznaky mŕtvice a infarktu; NIDDK: hnačka a zápcha) a boli skontrolované s týmito stránkami 15. októbra 2026. Každá položka obsahuje vlastný nadpis zdroja (context), jeho radu (quote), skupinu, na ktorú sa vzťahuje (applies_to), zdroj s licenciou a uvedením autora, review: source_verified a poznámku, že nejde o diagnózu a nebola skontrolovaná klinickým lekárom. Zdroje sú americké: kde citácia hovorí 9-1-1, poznámka dodáva, že núdzové číslo v Európe je 112.
• Žiadne príčiny ani asociácie stavov nie sú poskytované: associations zostáva prázdne, kým klinický lekár neskontroluje položku. Asociácia je vždy "môže byť spojená s".
• SNOMED CT kódy sú uvedené iba tam, kde to licencia umožňuje (pozri FHIR code systems).
• Skoršie pozorované symptómy dostanú kódovanie konceptu Anpheros pri ich ďalšej aktualizácii.

Súvisiace

• Anpheros Symptom Engine: metodika: ako sú koncepty priradené, skontrolované a vyhodnotené
• Anpheros Search: jedno vyhľadávanie cez symptómy, stavy a liečby, so zdrojmi
• FHIR kódové systémy: každý kódový systém podľa typu zdroja
• API pre longitudinálne dáta pacienta
• Ako ukladať lekárske záznamy pomocou FHIR R4
• FHIR platforma

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