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

Tünetadat API: koncepciók, FHIR terminológia és páciens által jelentett tünetek

Stabil tünetazonosítók, amelyek ICD-10-hez vannak rendelve, REST-ként és FHIR CodeSystem, ValueSet és ConceptMap formátumban; hogyan néz ki egy páciens által jelentett tünet megfigyelés (Observation) és hogyan lehet validálni.

Az Anpheros minden tünethez stabil azonosítót rendel (a SYM-0047 a fejfájás), hozzárendeli az ICD-10-hez, és a listát REST végponton, valamint FHIR R4 terminológiaként (CodeSystem, ValueSet, ConceptMap, $lookup) biztosítja. A betegek által jelentett tüneteket FHIR Observation-ként tároljuk, amelyek tartalmazzák mindkét kódot, a személy saját szavait, az intenzitást, és ha ismert, a tünet kezdő és befejező időpontját. Ez az oldal bemutatja, hogyan találhat meg egy fogalmat, hogyan néz ki egy beteg által jelentett tünet, hogyan ellenőrizheti a saját maga által írtat, és mit nem tartalmaz szándékosan az adat.

A kiadás tartalma

Az azonosítókat soha nem használják újra. Egy visszavont fogalom a listában marad a status: deprecated jelzéssel.

Koncepció keresése (REST)

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

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

q egyezik a koncepció azonosítójával, az ICD-10 és ICD-11 kódokkal, a címkékkel és az egyező kifejezésekkel. További paraméterek: icd10=R51 (a koncepció egy kódhoz), icd11=MB4D, body_system=nervous, kind=symptom|finding|all, lang=de (a display nyelve: a preferált címke, egyébként a laikus címke, egyébként angol), limit és 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 felsorolja az összes kiszolgált címkét (20 nyelv; itt rövidítve). Egy koncepció: GET $API/terminology/symptoms/SYM-0047.

Ugyanaz a lista, mint a FHIR terminológia

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 (a kiadást nem értékelte orvos); tulajdonságok kind, status, icd10; román címkék, egyező kifejezések és laikus címkék designation-ként.
• ValueSet/anpheros-symptoms — az aktív tünetek (kizárva a leletek); $expand vesz igénybe filter, displayLanguage, count és offset.
• ConceptMap/anpheros-symptom-to-icd10 — equivalent, vagy wider, ha az ICD-10 kód szélesebb körű, mint a fogalom (H53.8 "Egyéb látászavarok" szélesebb, mint az elmosódott látás).
• Mindegyik csak olvasható, és a szerver CapabilityStatement-ében (GET $BASE/metadata) szerepel.

Egy páciens által jelentett tünet

Így írja le az Anpheros Daily egy tünetet, amelyet egy személy magára vonatkozóan jelentett:

{
  "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 mindig a személy saját szavai, az ő nyelvén (Observation.language); a kódok mellette helyezkednek el.
• effectivePeriod akkor használatos, amikor a személy megmondta, mikor kezdődött vagy fejeződött be; egyébként effectiveDateTime az a pillanat, amikor azt feljegyezte. Az időpontok megtartják a rögzítő telefon eltolódását.
• valueQuantity az intenzitás 1–10-es skálán; nélküle nincs érték.
• Amikor a személy szerkeszt egy tünetet, ugyanaz az erőforrás kap egy új verziót — a korábbiakat a GET $BASE/Observation/{id}/_history segítségével olvashatja el.
• Szűrés kategória szerint a ?category=symptom segítségével; a beleegyezési hatókörök, mint például a patient/Observation.rs?category=symptom, ugyanúgy működnek.

Mi soha nem publikálható tünetként

Csak azok a tünetek válnak megfigyelésekké (Observations), amelyek jelen vannak és a páciensre vonatkoznak, és csak miután a szabad szöveget normalizálták. "A fejem már nem fáj", "talán holnap lázas leszek", "anyámnak köhögése van", vagy egy olyan szöveg, amelyet a normalizáló nem tudott elolvasni, nem válik a páciens tünetévé; ha egy publikált tünetet később ezek egyikére javítanak, annak megfigyelését visszavonják (puha törlés — az előzmények megmaradnak). A rokonok panaszai nem válnak automatikusan családi anamnézissé.

Tünet ellenőrzése, amit beír

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

A anpheros-symptom profil (kanonikus https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation) a következőket jelenti OperationOutcome-ként:

Mint a többi profil, ez is jelentést tesz, de nem utasítja el a beírásokat. Az Ön által küldött meta.profile megmarad a tárolt erőforráson.

Korlátok

• A kiadás nem esett át orvosi felülvizsgálaton; kódolási és keresési célokra használható, orvosi döntésekhez nem.
• A figyelmeztető jelek szó szerint idézve vannak nyilvánosan elérhető amerikai szövetségi oldalról (CDC: stroke és szívroham jelek; NIDDK: hasmenés és székrekedés), és 2026. október 15-én ellenőrizték azokat az említett oldalakkal. Minden elem tartalmazza a forrás saját címét (context), tanácsát (quote), a rá vonatkozó csoportot (applies_to), a licencet és az idézést tartalmazó forrást (review: source_verified), valamint azt a megjegyzést, hogy ez nem diagnózis, és nem esett át orvosi felülvizsgálaton. A források amerikaiak: ahol egy idézet 9-1-1-et említ, a megjegyzés hozzáteszi, hogy Európában a segélyhívószám 112.
• Nincsenek okok vagy állapot-asszociációk megjelenítve: a associations üres marad, amíg egy orvos felül nem vizsgál egy elemet. Egy asszociáció mindig "asszociálható".
• A SNOMED CT kódok csak ott szerepelnek, ahol a licenc ezt megengedi (lásd FHIR kódrendszerek).
• Korábbi tünet megfigyelések az Anpheros koncepció kódolását kapják a következő frissítéskor.

Kapcsolódó

• Anpheros Symptom Engine: módszertan: hogyan történik a koncepciók hozzárendelése, ellenőrzése és értékelése
• Anpheros Search: egyetlen keresés tünetek, állapotok és kezelések között, forrásokkal
• FHIR kódrendszerek: minden kódrendszer erőforrástípusonként
• Longitudinal patient data API
• Orvosi nyilvántartások tárolása FHIR R4 használatával
• FHIR platform

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