# API pre dáta o symptómoch: koncepty, terminológia FHIR a symptómy hlásené pacientom > Stabilné identifikátory symptómov namapované na ICD-10, slúžiace ako REST a ako FHIR CodeSystem, ValueSet a ConceptMap; ako vyzerá symptóm hlásený pacientom v rámci Observation a ako ho validovať. Source: https://developers.anpheros.com/sk/guides/symptom-data-api **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 | | | |---|---| | Verzia | `2026.10.4` (každá odpoveď uvádza, ktorá) | | Koncepty | 274: 197 symptómov (ICD-10 R00–R69 a ich podkategórie bez rezíduí, ako napr. R06.0 dyspnoe alebo R43.0 anosmia, plus kód WHO, kde WHO klasifikuje symptóm inak: G47, H53.2, H53.8, H93.1, K59.0, L29.9, M25.5, M54) a 77 nálezov (R65, R70–R94) | | Systém identifikátorov | `https://anpheros.com/fhir/CodeSystem/symptom` | | Kódy | skontrolované voči WHO ICD-10 Verzia 2019 (15. októbra 2026) s poznámkami o zahrnutí a vylúčení; názvy WHO ICD-10 sa nezobrazujú, kým WHO nepotvrdí licenciu (`icd10.display: null`), oficiálny anglický názov je názov ICD-11 | | ICD-11 | každý koncept je mapovaný na kód ICD-11 MMS 2025-01 (kód symptómu z kapitoly 21) a na telesný systém | | Zobrazené štítky | anglický názov WHO ICD-11 (`source`), rumunské štítky a zodpovedajúce výrazy používané Anpheros Daily (`in_use`) a bežné štítky v 19 ďalších jazykoch (`ai_reviewed`: strojové preklady revidované s pomocou AI, nie profesionálnym lekárskym prekladateľom); pre 188 konceptov pridaných vo verzii 2026.10.3 je rumunský názov tiež AI prekladom | | Klinické hodnotenie | `clinical_review: false` — žiadny lekár túto verziu nehodnotil; žiadne príčiny ani asociácie stavov | | Varovné príznaky | 32, pre 14 konceptov, citované slovo od slova zo stránok CDC a NIDDK (`review: source_quoted`) | Identifikátory sa nikdy nepoužívajú opakovane. Koncept, ktorý je stiahnutý, zostáva v zozname s `status: deprecated`. ## Nájsť koncept (REST) ```bash 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`. ```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` 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 ```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` (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: ```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` 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 ```bash 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`: | Pravidlo | Závažnosť | |---|---| | Kategória `urn:anpheros:observation-category\|symptom` (systém HL7 `observation-category` nemá žiadny kód `symptom`) | error | | `code.text` prítomné | error | | Koncept Anpheros, ktorý existuje a zodpovedá kódu ICD-10 | error | | `subject` je Pacient; `status` konečné, upravené, opravené alebo zadané s chybou; `effective[x]` prítomné; `effectivePeriod.end` nie skôr ako `start` | error | | Intenzita ako UCUM `{score}` medzi 0 a 10 | error | | Iba voľný text, žiadne kódy | information (stále platné) | 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](https://developers.anpheros.com/sk/guides/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](https://developers.anpheros.com/sk/guides/symptom-engine): ako sú koncepty priradené, skontrolované a vyhodnotené - [Anpheros Search](https://developers.anpheros.com/sk/guides/anpheros-search): jedno vyhľadávanie cez symptómy, stavy a liečby, so zdrojmi - [FHIR kódové systémy](https://developers.anpheros.com/sk/guides/fhir-code-systems): každý kódový systém podľa typu zdroja - [API pre longitudinálne dáta pacienta](https://developers.anpheros.com/sk/guides/longitudinal-patient-data-api) - [Ako ukladať lekárske záznamy pomocou FHIR R4](https://developers.anpheros.com/sk/guides/store-medical-records-fhir) - [FHIR platforma](https://developers.anpheros.com/sk/guides/fhir)