# Tünetadat API: fogalmak, FHIR terminológia és beteg által jelentett tünetek > Stabil tünetazonosítók, amelyek az ICD-10-hez vannak rendelve, REST és FHIR CodeSystem, ValueSet és ConceptMap formátumban; hogyan néz ki egy beteg által jelentett tünet megfigyelése (Observation), és hogyan lehet validálni azt. Source: https://developers.anpheros.com/hu/guides/symptom-data-api **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 | | | |---|---| | Kiadás | `2026.10.4` (minden válasz megadja, melyik) | | Fogalmak | 274: 197 tünet (ICD-10 R00–R69 és nem maradvány alcsoportjaik, mint például R06.0 dyspnoea vagy R43.0 anosmia, plusz a WHO kód, ahol a WHO máshol osztályozza a tünetet: G47, H53.2, H53.8, H93.1, K59.0, L29.9, M25.5, M54) és 77 lelet (R65, R70–R94) | | Azonosító rendszer | `https://anpheros.com/fhir/CodeSystem/symptom` | | Kódok | ellenőrizve a WHO ICD-10 2019-es verziójával (2026. október 15.), beleértve annak be- és kizárási jegyzeteit; a WHO ICD-10 címek nem kerülnek kiszolgálásra, amíg a WHO meg nem erősíti a licencet (`icd10.display: null`), az angol hivatalos cím az ICD-11 címe | | ICD-11 | minden fogalom megfeleltethető egy ICD-11 MMS 2025-01 kódnak (a 21. fejezet tünetkódja) és egy testrendszernek | | Kiszolgált címkék | a WHO ICD-11 angol címe (`source`), a román címkék és a Anpheros Daily által használt egyező kifejezések (`in_use`), valamint laikus címkék 19 további nyelven (`ai_reviewed`: gépi fordítások, AI segítséggel felülvizsgálva, nem professzionális orvosi fordító által); a 2026.10.3-ban hozzáadott 188 fogalom esetében a román név is AI fordítás | | Klinikai felülvizsgálat | `clinical_review: false` — egyetlen orvos sem vizsgálta felül a kiadást; nincsenek okok vagy feltétel-asszociációk | | Figyelmeztető jelek | 32, 14 fogalomra, szó szerint idézve a CDC és NIDDK oldalairól (`review: source_quoted`) | 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) ```bash 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`. ```json { "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 ```bash 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: ```json { "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 ```bash 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: | Szabály | Súlyosság | |---|---| | Kategória `urn:anpheros:observation-category\|symptom` (az HL7 `observation-category` rendszernek nincs `symptom` kódja) | error | | `code.text` jelen van | error | | Egy Anpheros koncepció, amely létezik és megegyezik az ICD-10 kóddal | error | | `subject` egy beteg; `status` végleges, módosított, javított vagy hibásan bevitt; `effective[x]` jelen van; `effectivePeriod.end` nem korábban, mint `start` | error | | Intenzitás UCUM `{score}`-ként 0 és 10 között | error | | Csak szabad szöveg, kódok nélkül | information (still valid) | 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](https://developers.anpheros.com/hu/guides/fhir-code-systems)). - 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](https://developers.anpheros.com/hu/guides/symptom-engine): hogyan történik a koncepciók hozzárendelése, ellenőrzése és értékelése - [Anpheros Search](https://developers.anpheros.com/hu/guides/anpheros-search): egyetlen keresés tünetek, állapotok és kezelések között, forrásokkal - [FHIR kódrendszerek](https://developers.anpheros.com/hu/guides/fhir-code-systems): minden kódrendszer erőforrástípusonként - [Longitudinal patient data API](https://developers.anpheros.com/hu/guides/longitudinal-patient-data-api) - [Orvosi nyilvántartások tárolása FHIR R4 használatával](https://developers.anpheros.com/hu/guides/store-medical-records-fhir) - [FHIR platform](https://developers.anpheros.com/hu/guides/fhir)