# Semptom verisi API'si: kavramlar, FHIR terminolojisi ve hasta tarafından bildirilen semptomlar > ICD-10'a eşlenmiş kararlı semptom tanımlayıcıları, REST ve FHIR CodeSystem, ValueSet ve ConceptMap olarak sunulur; hasta tarafından bildirilen bir semptom Observation'ı nasıl görünür ve birini nasıl doğrulayabilirsiniz. Source: https://developers.anpheros.com/tr/guides/symptom-data-api **Anpheros, her semptoma kararlı bir tanımlayıcı (`SYM-0047` baş ağrısıdır) atar, bunu ICD-10'a eşler ve listeyi bir REST uç noktası aracılığıyla ve FHIR R4 terminolojisi (`CodeSystem`, `ValueSet`, `ConceptMap`, `$lookup`) olarak sunar. Hastaların bildirdiği semptomlar, hem kodları, kişinin kendi kelimelerini, yoğunluğu ve biliniyorsa semptomun ne zaman başladığını ve bittiğini taşıyan FHIR `Observation`'ler olarak saklanır.** Bu sayfa, bir kavramın nasıl bulunacağını, hasta tarafından bildirilen bir semptomun nasıl göründüğünü, kendiniz yazdığınız bir semptomu nasıl kontrol edeceğinizi ve verinin kasıtlı olarak neleri içermediğini gösterir. ## Sürümde Neler Var | | | |---|---| | Sürüm | `2026.10.4` (her yanıt hangisi olduğunu belirtir) | | Kavramlar | 274: 197 semptom (ICD-10 R00–R69 ve R06.0 dispne veya R43.0 anosmi gibi kalıntı içermeyen alt kategorileri, ayrıca semptomu başka yerde sınıflandıran WHO kodları: G47, H53.2, H53.8, H93.1, K59.0, L29.9, M25.5, M54) ve 77 bulgu (R65, R70–R94) | | Tanımlayıcı sistemi | `https://anpheros.com/fhir/CodeSystem/symptom` | | Kodlar | WHO ICD-10 Sürüm 2019 (15 Ekim 2026) ile, dahil etme ve hariç tutma notlarıyla kontrol edildi; WHO lisansı onaylayana kadar WHO ICD-10 başlıkları sunulmaz (`icd10.display: null`), İngilizce resmi başlık ICD-11'dir | | ICD-11 | her kavram bir ICD-11 MMS 2025-01 koduna (bölüm 21 semptom kodu) ve bir vücut sistemine eşlenir | | Sunulan Etiketler | WHO ICD-11 İngilizce başlığı (`source`), Anpheros Daily tarafından kullanılan Romence etiketler ve eşleşen terimler (`in_use`) ve 19 dilde daha halk etiketleri (`ai_reviewed`: profesyonel bir tıbbi çevirmen tarafından değil, yapay zeka yardımıyla gözden geçirilen makine çevirileri); 2026.10.3'te eklenen 188 kavram için Romence isim de bir yapay zeka çevirisidir | | Klinik inceleme | `clinical_review: false` — hiçbir klinisyen sürümü incelememiştir; neden veya durum ilişkisi yoktur | | Uyarı işaretleri | 32, 14 kavram için, CDC ve NIDDK sayfalarından kelimesi kelimesine alıntılanmıştır (`review: source_quoted`) | Tanımlayıcılar asla yeniden kullanılmaz. Geri çekilen bir kavram, `status: deprecated` ile listede kalır. ## Bir kavram bulun (REST) ```bash export API=https://platform.anpheros.com/v1 export KEY=sk_test_… curl "$API/terminology/symptoms?q=headache" -H "Authorization: Bearer $KEY" ``` `q`, kavram kimliği, ICD-10 ve ICD-11 kodları, etiketler ve eşleşme terimleriyle eşleşir. Diğer parametreler: `icd10=R51` (bir kod için kavram), `icd11=MB4D`, `body_system=nervous`, `kind=symptom|finding|all`, `lang=de` (`display`'nin dili: tercih edilen etiket, aksi takdirde yaygın etiket, aksi takdirde İngilizce), `limit` ve `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`, sunulan her etiketi (20 dil; burada kısaltılmıştır) listeler. Bir kavram: `GET $API/terminology/symptoms/SYM-0047`. ## FHIR terminolojisi ile aynı liste ```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` (sürüm bir klinisyen tarafından incelenmemiştir); `kind`, `status`, `icd10` özellikleri; Romence etiketleri, `designation` olarak terim ve halk etiketleriyle eşleşir. - `ValueSet/anpheros-symptoms` — aktif semptomlar (bulgular hariç); `$expand`, `filter`, `displayLanguage`, `count` ve `offset` alır. - `ConceptMap/anpheros-symptom-to-icd10` — `equivalent` veya ICD-10 kodu kavramdan daha fazlasını kapsadığında `wider` (H53.8 "Diğer görsel bozukluklar" bulanık görmeden daha geniştir). - Hepsi salt okunur ve sunucunun `CapabilityStatement` (`GET $BASE/metadata`) listesinde yer alır. ## Bir hasta tarafından bildirilen semptom Anpheros Daily, bir kişinin kendisi hakkında mevcut olduğunu bildirdiği bir semptomu şu şekilde yazar: ```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` her zaman kişinin kendi kelimeleridir, kendi dilinde (`Observation.language`); kodlar bunun yanında yer alır. - Kişi ne zaman başladığını veya bittiğini söylediğinde `effectivePeriod` kullanılır; aksi takdirde `effectiveDateTime`, kaydettiği andır. Saatler, onları kaydeden telefonun saat dilimini korur. - `valueQuantity`, 1-10 ölçeğindeki yoğunluktur; biri olmadan bir değer yoktur. - Kişi bir semptomu düzenlediğinde, aynı kaynak yeni bir sürüm alır — önceki sürümleri `GET $BASE/Observation/{id}/_history` ile okuyun. - Kategoriye göre filtrelemek için `?category=symptom`; `patient/Observation.rs?category=symptom` gibi izin kapsamları aynı şekilde çalışır. ### Semptom olarak asla yayınlanmayanlar Yalnızca **mevcut** ve **hastayla ilgili** semptomlar, serbest metin normalleştirildikten sonra Gözlemler (Observations) haline gelir. "Başım artık ağrımıyor", "belki yarın ateş", "annemin öksürüğü var" veya normalleştiricinin okuyamadığı bir metin hastanın semptomu olmaz; yayınlanan bir semptom daha sonra bunlardan birine düzeltilirse, Gözlemi geri çekilir (soft delete — geçmişi kalır). Akrabaların şikayetleri otomatik olarak aile geçmişine dönüştürülmez. ## Bir semptomu yazdığınızda kontrol edin ```bash curl -X POST "$BASE/Observation/\$validate?profile=anpheros-symptom" -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/fhir+json" -d @symptom.json ``` `anpheros-symptom` profili (canonical `https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation`), bir `OperationOutcome` olarak şunu bildirir: | Kural | Ciddiyet | |---|---| | Kategori `urn:anpheros:observation-category\|symptom` (HL7 `observation-category` sisteminde `symptom` kodu yok) | error | | `code.text` mevcut | error | | ICD-10 koduna uyan ve mevcut olan bir Anpheros konsepti | error | | `subject` bir Patient'tır; `status` son, değiştirilmiş, düzeltilmiş veya hataya girilmiş; `effective[x]` mevcut; `effectivePeriod.end` `start` tarihinden önce değil | error | | Yoğunluk, 0 ile 10 arasında UCUM `{score}` olarak | error | | Yalnızca serbest metin, kod yok | information (still valid) | Diğer profiller gibi, yazma işlemlerini reddetmez, bildirir. Gönderdiğiniz bir `meta.profile`, saklanan kaynakta tutulur. ## Sınırlamalar - Sürüm bir klinisyen tarafından incelenmemiştir; tıbbi kararlar için değil, kodlama ve arama için kullanın. - Uyarı işaretleri, kamu malı ABD federal sayfalarından (CDC: inme ve kalp krizi belirtileri; NIDDK: ishal ve kabızlık) kelimesi kelimesine alıntılanmıştır ve 15 Ekim 2026 tarihinde bu sayfalara karşı kontrol edilmiştir. Her öğe, kaynağın kendi başlığını (`context`), tavsiyesini (`quote`), uygulandığı grubu (`applies_to`), lisans ve atıf ile birlikte kaynağı (`review: source_verified`) ve teşhis olmadığını ve bir klinisyen tarafından incelenmediğini belirten notu taşır. Kaynaklar Amerikandır: bir alıntı 9-1-1 dediğinde, not Avrupa'daki acil durum numarasının 112 olduğunu ekler. - Hiçbir neden veya durum ilişkisi sunulmamaktadır: bir klinisyen bir öğeyi inceleyene kadar `associations` boş kalır. Bir ilişki her zaman "ilişkili olabilir" şeklindedir. - SNOMED CT kodları yalnızca lisansın izin verdiği yerlerde yazılır (bkz. [FHIR kod sistemleri](https://developers.anpheros.com/tr/guides/fhir-code-systems)). - Daha önceki belirti Gözlemleri, bir sonraki güncellenmelerinde Anpheros konsept kodlamasını alır. ## İlgili Konular - [Anpheros Semptom Motoru: metodoloji](https://developers.anpheros.com/tr/guides/symptom-engine): kavramların nasıl atandığı, kontrol edildiği ve değerlendirildiği - [Anpheros Arama](https://developers.anpheros.com/tr/guides/anpheros-search): semptomlar, durumlar ve tedaviler üzerinde kaynaklarla birlikte tek bir arama - [FHIR kod sistemleri](https://developers.anpheros.com/tr/guides/fhir-code-systems): kaynak türüne göre her kod sistemi - [Boylamsal hasta verileri API](https://developers.anpheros.com/tr/guides/longitudinal-patient-data-api) - [FHIR R4 kullanarak tıbbi kayıtların nasıl saklanacağı](https://developers.anpheros.com/tr/guides/store-medical-records-fhir) - [FHIR platformu](https://developers.anpheros.com/tr/guides/fhir)