# मेडिकल डेटा एपीआई

> एनफेरोस एपीआई में प्रत्येक प्रकार का मेडिकल डेटा कहाँ जाता है, इसे कैसे कोड किया जाता है, और इसे कैसे लिखें, फ़िल्टर करें, ट्रेस करें, सही करें और हटाएं - काम करने वाले उदाहरणों के साथ।

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

**एक मेडिकल डेटा एपीआई सॉफ्टवेयर को रोगी रिकॉर्ड की सामग्री तक संरचित पहुंच प्रदान करता है: एक रोगी बनाएं, रक्तचाप रीडिंग रिकॉर्ड करें, सक्रिय दवाएं सूचीबद्ध करें, एक लैब रिपोर्ट संलग्न करें, ट्रेस करें कि किसने क्या लिखा।** यह पृष्ठ एनफेरोस एपीआई के डेटा ऑपरेशंस का वर्णन करता है - किस प्रकार का मेडिकल डेटा कहाँ जाता है, इसे कैसे कोड किया जाता है, और इसे कैसे पढ़ा जाता है - सैंडबॉक्स के विरुद्ध काम करने वाले उदाहरणों के साथ।

एप्लिकेशन एनफेरोस को अपने उत्पाद के मेडिकल डेटाबेस के रूप में मानने के लिए इन ऑपरेशंस का उपयोग करते हैं: रोगी रिकॉर्ड प्लेटफॉर्म के HL7 FHIR R4 स्टोर में रहते हैं, और एप्लिकेशन अपने स्वयं के मेडिकल डेटा टेबल रखने के बजाय एपीआई के माध्यम से उन्हें पढ़ता और लिखता है।

व्यापक तस्वीर (प्रमाणीकरण, सहमति, ईवेंट) के लिए [हेल्थकेयर एपीआई](https://developers.anpheros.com/hi/guides/healthcare-api) देखें।

## प्रत्येक प्रकार का मेडिकल डेटा कहाँ जाता है

| मेडिकल डेटा | REST v1 | FHIR रिसोर्स | कोडिंग |
|---|---|---|---|
| व्यक्ति | `POST /v1/patients` | `Patient` | नाम, जन्म तिथि, लिंग, पहचानकर्ता |
| वाइटल साइन्स, लैब परिणाम, लक्षण, गतिविधि, सर्वेक्षण | `/v1/patients/{id}/observations` | `Observation` | LOINC (लक्षण: ICD-10 अध्याय R); UCUM इकाइयाँ |
| निदान और समस्याएँ | `/v1/patients/{id}/conditions` | `Condition` | ICD-10 |
| दवाएँ | `/v1/patients/{id}/medications` | `MedicationStatement` | ATC, उत्पाद का नाम टेक्स्ट के रूप में रखा गया |
| दस्तावेज़ (PDF, छवियाँ) | `/v1/patients/{id}/documents` | `DocumentReference` | LOINC दस्तावेज़ प्रकार |
| एक पूरा लैब रिपोर्ट | `POST /v1/patients/{id}/labs/import` | `Observation` (प्रयोगशाला) | LOINC जहाँ ज्ञात हो, अन्यथा लैब का अपना कोड |
| ली गई या छोड़ी गई खुराकें, टीकाकरण, एलर्जी, प्रक्रियाएँ, रिपोर्ट, देखभाल योजनाएँ, लक्ष्य, रेफरल, विज़िट, अपॉइंटमेंट, देखभाल टीमें, पारिवारिक इतिहास, प्रश्नावली | `/fhir/R4/{type}` | `MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse` | प्रति [FHIR कोड सिस्टम](https://developers.anpheros.com/hi/guides/fhir-code-systems) |

REST v1 ऑब्जेक्ट और FHIR रिसोर्स समान रिकॉर्ड हैं जिनके आईडी समान हैं; प्रत्येक v1 ऑब्जेक्ट अपना `fhir` संदर्भ रखता है।

## मेडिकल डेटा लिखना

```bash
# a lab result with its reference range, linked to the report it came from
curl -X POST https://platform.anpheros.com/v1/patients/$PID/observations \
     -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" -d '{
  "code": "4548-4", "display": "Hemoglobin A1c", "category": "laboratory",
  "value": 6.4, "unit": "%", "effective_at": "2026-09-01T08:00:00Z",
  "reference_range": {"low": 4.0, "high": 5.6},
  "derived_from": ["DocumentReference/'$DOC'"], "author_type": "import"
}'
```

- **Observation categories:** `vital-signs`, `laboratory`, `symptom`, `activity`, `survey`, `exam`, `imaging`, `social-history`.
- **Composite measurements** जैसे ब्लड प्रेशर `components` (systolic `8480-6`, diastolic `8462-4` panel `85354-9` के अंदर) का उपयोग करते हैं।
- **Author types:** `patient`, `practitioner`, `device`, `import`, `ai`. इनमें से किसी के बिना, प्लेटफ़ॉर्म `import` रिकॉर्ड करता है।
- **Codes you do not know by heart:** `GET /v1/terminology/loinc?q=hba1c` बंडल किए गए LOINC सबसेट को खोजता है और `GET /v1/search?q=metformin` लक्षणों, स्थितियों और दवाओं के कैटलॉग को; डिस्प्ले नाम के बिना लिखा गया एक ऑब्ज़र्वेशन स्वचालित रूप से LOINC नाम प्राप्त करता है।

## चिकित्सा डेटा पढ़ना

```bash
curl "https://platform.anpheros.com/v1/patients/$PID/observations?category=laboratory&code=4548-4&from=2026-01-01" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/conditions?clinical_status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"
```

| एंडपॉइंट | फ़िल्टर |
|---|---|
| observations | `category`, `code`, `from`, `to` |
| conditions | `clinical_status` |
| medications | `status` |
| documents | `kind` |
| timeline | `from`, `to`, `types` |

सूचियाँ `limit` और `cursor` के साथ पृष्ठित होती हैं। **timeline** observations, conditions, medications, documents, visits, appointments, vaccinations और episodes of care को एक कालानुक्रमिक सूची में मर्ज करता है — एक रोगी इतिहास स्क्रीन के लिए प्राकृतिक इनपुट।

किसी भी चीज़ के लिए जो REST फ़िल्टर कवर नहीं करते हैं, FHIR खोज का उपयोग करें: `GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date` ([FHIR platform](https://developers.anpheros.com/hi/guides/fhir))।

## डेटा का पता लगाना और सुधारना

- **किसने लिखा:** `GET /v1/patients/{id}/provenance/{type}/{resourceId}` — प्रत्येक संस्करण के लिए एक प्रविष्टि, जिसमें लेखक का प्रकार, प्रोजेक्ट, संगठन और स्रोत सिस्टम शामिल है।
- **हर संस्करण:** `GET /fhir/R4/{type}/{id}/_history`; किसी और के बदलाव को ओवरराइट करने से बचने के लिए `If-Match` के साथ अपडेट करें।
- **स्वामित्व:** सहमति से आप पढ़ सकते हैं कि अन्य संगठनों ने क्या लिखा है, लेकिन केवल वही बदलें या हटाएं जो आपके प्रोजेक्ट ने लिखा है (अन्यथा `403`)।
- **हटाना:** `DELETE /v1/{observations|conditions|medications}/{id}`; `Patient` को हटाने से पूरा रिकॉर्ड हट जाता है।

## दस्तावेज़

दस्तावेज़ बनाएँ (आपको एक अपलोड लक्ष्य मिलता है), प्लेटफ़ॉर्म के माध्यम से या सीधे स्टोरेज में बाइट्स अपलोड करें, फिर अंतिम रूप दें। अंतिम रूप देने के बाद मूल अपरिवर्तनीय हो जाता है; इसका SHA-256 और आकार दर्ज किया जाता है। प्रति फ़ाइल 25 MiB तक।

## संबंधित

- [चिकित्सा डेटा को सामान्य कैसे करें](https://developers.anpheros.com/hi/guides/normalize-medical-data): कोड, इकाइयाँ, तिथियाँ, डुप्लिकेट, सत्यापन
- [चिकित्सा डेटा की उत्पत्ति समझाई गई](https://developers.anpheros.com/hi/guides/medical-data-provenance): किसने क्या लिखा, और इसे कैसे रिकॉर्ड करें
- [हेल्थकेयर एपीआई](https://developers.anpheros.com/hi/guides/healthcare-api)
- [रोगी का मेडिकल रिकॉर्ड](https://developers.anpheros.com/hi/guides/patient-medical-record)
- [हेल्थकेयर ऐप बनाएँ](https://developers.anpheros.com/hi/guides/build-a-healthcare-app)
- [एपीआई संदर्भ (OpenAPI)](https://developers.anpheros.com/docs) · [शुरुआत करें](https://developers.anpheros.com/hi/guides/getting-started)