# लक्षण डेटा API: अवधारणाएँ, FHIR शब्दावली और रोगी-रिपोर्ट किए गए लक्षण

> ICD-10 से मैप किए गए स्थिर लक्षण पहचानकर्ता, REST और FHIR CodeSystem, ValueSet और ConceptMap के रूप में परोसे जाते हैं; रोगी-रिपोर्ट किया गया लक्षण Observation कैसा दिखता है और एक को कैसे मान्य किया जाए।

Source: https://developers.anpheros.com/hi/guides/symptom-data-api

**Anpheros हर लक्षण को एक स्थिर पहचानकर्ता (`SYM-0047` सिरदर्द है) देता है, इसे ICD-10 पर मैप करता है, और सूची को REST एंडपॉइंट के माध्यम से और FHIR R4 शब्दावली (`CodeSystem`, `ValueSet`, `ConceptMap`, `$lookup`) के रूप में परोसता है। रोगी द्वारा रिपोर्ट किए गए लक्षण FHIR `Observation` के रूप में संग्रहीत किए जाते हैं जिनमें दोनों कोड, व्यक्ति के अपने शब्द, तीव्रता और, जब ज्ञात हो, लक्षण कब शुरू हुआ और समाप्त हुआ, शामिल होते हैं।** यह पृष्ठ दिखाता है कि किसी अवधारणा को कैसे खोजना है, रोगी-रिपोर्ट किया गया लक्षण कैसा दिखता है, आप स्वयं द्वारा लिखे गए किसी लक्षण की जांच कैसे कर सकते हैं, और डेटा में जानबूझकर क्या शामिल नहीं है।

## रिलीज़ में क्या है

| | |
|---|---|
| रिलीज़ | `2026.10.4` (हर प्रतिक्रिया बताती है कि कौन सी है) |
| अवधारणाएँ | 274: 197 लक्षण (ICD-10 R00–R69 और उनकी गैर-अवशिष्ट उपश्रेणियाँ जैसे R06.0 डिस्प्निया या R43.0 एनोस्मिया, साथ ही WHO कोड जहाँ WHO लक्षण को कहीं और वर्गीकृत करता है: G47, H53.2, H53.8, H93.1, K59.0, L29.9, M25.5, M54) और 77 निष्कर्ष (R65, R70–R94) |
| पहचानकर्ता प्रणाली | `https://anpheros.com/fhir/CodeSystem/symptom` |
| कोड | WHO ICD-10 संस्करण 2019 (15 अक्टूबर 2026) के विरुद्ध जाँचे गए, जिसमें इसके समावेश और बहिष्करण नोट्स शामिल हैं; WHO ICD-10 शीर्षक तब तक सेवा में नहीं दिए जाते जब तक WHO लाइसेंस की पुष्टि नहीं कर देता (`icd10.display: null`), अंग्रेजी आधिकारिक शीर्षक ICD-11 वाला है |
| ICD-11 | हर अवधारणा ICD-11 MMS 2025-01 कोड (अध्याय 21 लक्षण कोड) और एक शारीरिक प्रणाली से मैप होती है |
| सेवा में लेबल | WHO ICD-11 अंग्रेजी शीर्षक (`source`), Anpheros Daily द्वारा उपयोग किए जाने वाले रोमानियाई लेबल और मैच शब्द (`in_use`), और 19 और भाषाओं में सामान्य लेबल (`ai_reviewed`: AI सहायता से समीक्षा किए गए मशीन अनुवाद, पेशेवर चिकित्सा अनुवादक द्वारा नहीं); 2026.10.3 में जोड़े गए 188 अवधारणाओं के लिए रोमानियाई नाम भी AI अनुवाद है |
| नैदानिक ​​समीक्षा | `clinical_review: false` — किसी भी चिकित्सक ने रिलीज़ की समीक्षा नहीं की है; कोई कारण या स्थिति संबंध नहीं |
| चेतावनी संकेत | 32, 14 अवधारणाओं के लिए, CDC और NIDDK पृष्ठों से शब्दशः उद्धृत (`review: source_quoted`) |

पहचानकर्ताओं का कभी भी पुन: उपयोग नहीं किया जाता है। वापस ली गई अवधारणा को `status: deprecated` के साथ सूची में रखा जाता है।

## एक कॉन्सेप्ट खोजें (REST)

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

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

`q` कॉन्सेप्ट आईडी, ICD-10 और ICD-11 कोड, लेबल और मैच टर्म्स से मेल खाता है। अन्य पैरामीटर: `icd10=R51` (एक कोड के लिए कॉन्सेप्ट), `icd11=MB4D`, `body_system=nervous`, `kind=symptom|finding|all`, `lang=de` (`display` की भाषा: पसंदीदा लेबल, अन्यथा सामान्य लेबल, अन्यथा अंग्रेजी), `limit` और `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` हर सर्व किए गए लेबल (20 भाषाएँ; यहाँ छोटा किया गया) को सूचीबद्ध करता है। एक कॉन्सेप्ट: `GET $API/terminology/symptoms/SYM-0047`।

## 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` (रिलीज़ की समीक्षा किसी चिकित्सक द्वारा नहीं की गई है); गुण `kind`, `status`, `icd10`; रोमानियाई लेबल, शब्दों और सामान्य लेबल को `designation` के रूप में मिलाएं।
- `ValueSet/anpheros-symptoms` — सक्रिय लक्षण (निष्कर्षों को छोड़कर); `$expand` लेता है `filter`, `displayLanguage`, `count` और `offset`।
- `ConceptMap/anpheros-symptom-to-icd10` — `equivalent`, या `wider` जब ICD-10 कोड अवधारणा से अधिक को कवर करता है (H53.8 "अन्य दृश्य गड़बड़ी" धुंधली दृष्टि से व्यापक है)।
- ये सभी केवल-पढ़ने योग्य हैं और सर्वर के `CapabilityStatement` (`GET $BASE/metadata`) में सूचीबद्ध हैं।

## एक रोगी-रिपोर्टेड लक्षण

यह दर्शाता है कि Anpheros Daily किसी व्यक्ति द्वारा स्वयं के बारे में बताए गए लक्षण को कैसे लिखता है:

```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` हमेशा व्यक्ति के अपने शब्द होते हैं, उनकी भाषा में (`Observation.language`); कोड उसके बगल में होते हैं।
- `effectivePeriod` का उपयोग तब किया जाता है जब व्यक्ति ने बताया कि यह कब शुरू हुआ या समाप्त हुआ; अन्यथा `effectiveDateTime` वह क्षण है जब उन्होंने इसे नोट किया। समय उन फोन के ऑफ़सेट को बनाए रखते हैं जिन्होंने उन्हें रिकॉर्ड किया था।
- `valueQuantity` 1-10 के पैमाने पर तीव्रता है; इसके बिना कोई मान नहीं है।
- जब व्यक्ति किसी लक्षण को संपादित करता है, तो उसी संसाधन को एक नया संस्करण मिलता है — पहले वाले को `GET $BASE/Observation/{id}/_history` के साथ पढ़ें।
- श्रेणी के अनुसार फ़िल्टर करें `?category=symptom` के साथ; सहमति स्कोप जैसे `patient/Observation.rs?category=symptom` उसी तरह काम करते हैं।

### क्या कभी लक्षण के रूप में प्रकाशित नहीं होता है

केवल वे लक्षण जो **उपस्थित** हैं और **रोगी के बारे में** हैं, वे Observations बन जाते हैं, और केवल मुक्त पाठ को सामान्यीकृत करने के बाद। "मेरे सिर में अब दर्द नहीं है", "शायद कल बुखार होगा", "मेरी माँ को खांसी है" या एक पाठ जिसे सामान्यकर्ता पढ़ नहीं सका, वह रोगी का लक्षण नहीं बनता है; यदि किसी प्रकाशित लक्षण को बाद में इनमें से किसी एक में ठीक किया जाता है, तो उसका Observation वापस ले लिया जाता है (सॉफ्ट डिलीट — इतिहास बना रहता है)। रिश्तेदारों की शिकायतें स्वचालित रूप से पारिवारिक इतिहास में नहीं बदलती हैं।

## एक लक्षण की जाँच करें जो आप लिखते हैं

```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` प्रोफ़ाइल (कैनोनिकल `https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation`) एक `OperationOutcome` के रूप में रिपोर्ट करती है:

| नियम | गंभीरता |
|---|---|
| श्रेणी `urn:anpheros:observation-category\|symptom` (HL7 `observation-category` सिस्टम में कोई `symptom` कोड नहीं है) | error |
| `code.text` मौजूद है | error |
| एक Anpheros अवधारणा जो मौजूद है और ICD-10 कोड से मेल खाती है | error |
| `subject` एक रोगी है; `status` अंतिम, संशोधित, सही या त्रुटि में दर्ज किया गया; `effective[x]` मौजूद है; `effectivePeriod.end` `start` से पहले नहीं | error |
| UCUM `{score}` के रूप में तीव्रता 0 और 10 के बीच | error |
| केवल मुक्त पाठ, कोई कोड नहीं | information (still valid) |

अन्य प्रोफ़ाइलों की तरह, यह लिखता है और लिखने को अस्वीकार नहीं करता है। आपके द्वारा भेजा गया एक `meta.profile` संग्रहीत संसाधन पर रखा जाता है।

## सीमाएँ (Limits)

- इस रिलीज़ की समीक्षा किसी चिकित्सक द्वारा नहीं की गई है; इसका उपयोग कोडिंग और खोज के लिए करें, न कि चिकित्सा निर्णयों के लिए।
- चेतावनी संकेत सार्वजनिक डोमेन अमेरिकी संघीय पृष्ठों (CDC: स्ट्रोक और दिल के दौरे के संकेत; NIDDK: दस्त और कब्ज) से शब्दशः उद्धृत किए गए हैं और 15 अक्टूबर 2026 को उन पृष्ठों के विरुद्ध जांचे गए थे। प्रत्येक आइटम में स्रोत का अपना शीर्षक (`context`), उसकी सलाह (`quote`), वह समूह जिस पर यह लागू होता है (`applies_to`), लाइसेंस और एट्रिब्यूशन के साथ स्रोत, `review: source_verified` और यह नोट कि यह निदान नहीं है और इसकी समीक्षा किसी चिकित्सक द्वारा नहीं की गई है। स्रोत अमेरिकी हैं: जहाँ एक उद्धरण 9-1-1 कहता है, वहाँ नोट जोड़ा जाता है कि यूरोप में आपातकालीन नंबर 112 है।
- कोई कारण या स्थिति संबंध (condition associations) नहीं परोसे जाते हैं: `associations` तब तक खाली रहता है जब तक कि कोई चिकित्सक किसी आइटम की समीक्षा नहीं कर लेता। एक संबंध हमेशा "may be associated with" होता है।
- SNOMED CT कोड केवल वहीं लिखे जाते हैं जहाँ लाइसेंस इसकी अनुमति देता है ( [FHIR कोड सिस्टम](https://developers.anpheros.com/hi/guides/fhir-code-systems) देखें)।
- पहले के लक्षण अवलोकन (symptom Observations) अगली बार अपडेट होने पर Anpheros अवधारणा कोडिंग प्राप्त करेंगे।

## संबंधित

- [Anpheros Symptom Engine: कार्यप्रणाली](https://developers.anpheros.com/hi/guides/symptom-engine): अवधारणाओं को कैसे असाइन, जांचा और मूल्यांकित किया जाता है
- [Anpheros Search](https://developers.anpheros.com/hi/guides/anpheros-search): लक्षणों, स्थितियों और उपचारों पर एक खोज, स्रोतों के साथ
- [FHIR कोड सिस्टम](https://developers.anpheros.com/hi/guides/fhir-code-systems): संसाधन प्रकार के अनुसार प्रत्येक कोड सिस्टम
- [लॉन्गिट्यूडनल पेशेंट डेटा API](https://developers.anpheros.com/hi/guides/longitudinal-patient-data-api)
- [FHIR R4 का उपयोग करके मेडिकल रिकॉर्ड कैसे स्टोर करें](https://developers.anpheros.com/hi/guides/store-medical-records-fhir)
- [FHIR प्लेटफॉर्म](https://developers.anpheros.com/hi/guides/fhir)