# अनुदैर्ध्य रोगी डेटा API

> क्लीनिक, लैब, ऐप्स और डिवाइस से समय के साथ एक रोगी का इतिहास: एक अनुदैर्ध्य रिकॉर्ड को क्या चाहिए, और इसे पढ़ने के चार तरीके - टाइमलाइन, $everything, IPS और AI संदर्भ।

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

**एक अनुदैर्ध्य रोगी डेटा API समय के साथ एक व्यक्ति के स्वास्थ्य इतिहास को लौटाता है - निदान, दवाएं, लैब परिणाम, महत्वपूर्ण संकेत, टीकाकरण और हर स्रोत से विज़िट - अलग-अलग प्रदाताओं के लिए अलग-अलग दस्तावेज़ों के बजाय एक क्रमबद्ध रिकॉर्ड के रूप में।** Anpheros उस इतिहास को प्रति रोगी एक एकल HL7 FHIR R4 रिकॉर्ड के रूप में रखता है, जिसे क्लीनिक, प्रयोगशालाओं, ऐप्स और उपकरणों द्वारा लिखा जाता है, जिसमें हर संस्करण और हर लेखक को रखा जाता है। डेवलपर्स इसे चार तरीकों से पढ़ते हैं: एक कालानुक्रमिक टाइमलाइन, `Patient/$everything` के साथ पूर्ण FHIR रिकॉर्ड, एक अंतर्राष्ट्रीय रोगी सारांश, या AI मॉडल के लिए एक कॉम्पैक्ट संदर्भ।

<!-- visual:longitudinal-sources -->

## "लॉन्गिटूडिनल" के लिए क्या आवश्यक है

परिणामों की एक सूची अभी तक एक लॉन्गिटूडिनल रिकॉर्ड नहीं है। किसी एप्लिकेशन को वर्षों और प्रदाताओं तक फैले इतिहास पर भरोसा करने के लिए, प्रत्येक प्रविष्टि में निम्नलिखित होना चाहिए:

| आवश्यकता | यह क्यों मायने रखता है | Anpheros इसे कैसे संग्रहीत करता है |
|---|---|---|
| एक कोडेड अर्थ | विभिन्न प्रयोगशालाओं के मान तुलनीय होने चाहिए | परिणामों के लिए LOINC, स्थितियों के लिए ICD-10, दवाओं के लिए ATC |
| एक नैदानिक ​​तिथि | जब यह हुआ उसके अनुसार क्रमबद्ध करना, न कि जब इसे अपलोड किया गया था | प्रत्येक संसाधन पर `effective`, `onset`, `occurrence` तिथियां |
| लेखक | डॉक्टर का निदान और रोगी का नोट समान नहीं हैं | प्रत्येक राइट पर प्रोवेनेंस: लेखक का प्रकार, व्यक्ति, संगठन, स्रोत प्रणाली |
| हर संस्करण | सुधारों को पहले ज्ञात जानकारी को मिटाना नहीं चाहिए | प्रत्येक संसाधन पर संस्करण इतिहास (`_history`) |
| सहमति | व्यक्ति सहमत होने पर ही अन्य एप्लिकेशन इतिहास देख सकते हैं | स्कोप, समाप्ति और एक्सेस लॉग के साथ OAuth अनुदान |

## एक रिकॉर्ड, कई लेखक

<!-- visual:longitudinal-timeline -->

## इतिहास पढ़ने के चार तरीके

| आवश्यकता | एंडपॉइंट | आपको क्या मिलता है |
|---|---|---|
| स्क्रीन के लिए एक कालानुक्रमिक फ़ीड | `GET /v1/patients/{id}/timeline` | आठ प्रकार की वस्तुएं (observation, condition, medication, document, encounter, appointment, immunization, episode) जिनमें तारीख, शीर्षक, सारांश और FHIR संदर्भ शामिल हैं; `from`, `to`, `types` के साथ फ़िल्टर करें |
| FHIR के रूप में पूरा रिकॉर्ड | `GET /fhir/R4/Patient/{id}/$everything` | एक searchset Bundle; `_since`, `_type`, `_count` और `_offset` समर्थित हैं |
| एक साझा करने योग्य नैदानिक सारांश | `GET /fhir/R4/Patient/{id}/$summary` | एक International Patient Summary (IPS) दस्तावेज़ |
| AI मॉडल के लिए इनपुट | `POST /v1/context` | एक टोकन बजट के भीतर अनुभाग, प्रत्येक तथ्य को उसके स्रोत के साथ लेबल किया गया है |

टाइमलाइन TypeScript SDK के साथ:

```ts
import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });   // a sandbox key, sk_test_…
const { data: patients } = await anpheros.patients.list();
const page = await anpheros.timeline.list(patients[0].id, {
  from: '2025-01-01',
  types: 'condition,medication,observation',
  limit: 50,
});
for (const item of page.data) console.log(item.date, item.type, item.title);
```

और वही रिकॉर्ड FHIR के रूप में, एक तारीख के बाद से जो बदला है, उस तक सीमित:

```bash
curl -H "Authorization: Bearer $ANPHEROS_KEY" \
  "https://platform.anpheros.com/fhir/R4/Patient/$PATIENT/\$everything?_since=2026-01-01&_type=Observation,Condition"
```

## अपनी कॉपी को सिंक में रखना

यदि आपका एप्लिकेशन इतिहास का अपना दृश्य रखता है, तो `resource.created`, `resource.updated` और `resource.deleted` वेबहुक की सदस्यता लें। वे तब भी फायर होते हैं जब कोई अन्य प्रोजेक्ट आपके द्वारा एक्सेस किए जाने वाले रिकॉर्ड में लिखता है, `data.external: true` और `data.source` में लेखक के साथ, इसलिए अन्य क्लीनिकों से डेटा बिना पोलिंग के आप तक पहुँचता है।

## जानने योग्य सीमाएँ

- रिकॉर्ड में वही लिखा होता है जो उसमें लिखा गया था। Anpheros अपने आप अस्पतालों या राष्ट्रीय नेटवर्क से इतिहास प्राप्त नहीं करता है; क्लिनिक, लैब, ऐप और व्यक्ति इसे लिखते हैं।
- 26 FHIR R4 संसाधन प्रकार संग्रहीत किए जाते हैं। बिलिंग संसाधन जैसे Claim और ExplanationOfBenefit नहीं किए जाते हैं।
- अन्य एप्लिकेशन किसी व्यक्ति के इतिहास को केवल उस व्यक्ति की सहमति से ही पढ़ते हैं; किसी प्रोजेक्ट की अपनी कुंजी उन रोगियों को देखती है जिन्हें उसने बनाया है।

## अक्सर पूछे जाने वाले प्रश्न

### अनुदैर्ध्य रोगी डेटा क्या है?
किसी व्यक्ति की स्वास्थ्य जानकारी जो समय के साथ और विभिन्न देखभाल सेटिंग्स में एकत्र की जाती है — निदान, दवाएं, परिणाम, महत्वपूर्ण संकेत, टीकाकरण और विज़िट — ताकि इसे एक सतत इतिहास के रूप में पढ़ा जा सके।

### कौन सा API रोगी के रिकॉर्ड का कालानुक्रमिक दृश्य देता है?
Anpheros में, `GET /v1/patients/{id}/timeline` आठ संसाधन प्रकारों से प्रविष्टियाँ दिनांक क्रम में, पेजिनेशन और दिनांक और प्रकार फिल्टर के साथ लौटाता है। पूर्ण FHIR डेटा के लिए `Patient/$everything` का उपयोग करें।

### क्या इतिहास एक मानक प्रारूप में संग्रहीत है?
हाँ। प्रत्येक प्रविष्टि एक HL7 FHIR R4 संसाधन है जिसमें मानक कोड (LOINC, ICD-10, ATC, CVX, UCUM) होते हैं, और सारांश एक अंतर्राष्ट्रीय रोगी सारांश है।

### मुझे कैसे पता चलेगा कि प्रत्येक प्रविष्टि किसने लिखी है?
प्रत्येक लेखन एक Provenance संसाधन बनाता है जिसमें लेखक का प्रकार (रोगी, चिकित्सक, उपकरण, आयात या AI), व्यक्ति, संगठन और स्रोत प्रणाली शामिल होती है।

### क्या मैं यथार्थवादी अनुदैर्ध्य डेटा के साथ परीक्षण कर सकता हूँ?
हाँ। प्रत्येक सैंडबॉक्स प्रोजेक्ट 30 सिंथेटिक रोगियों के साथ शुरू होता है, जिनमें लगभग छह महीने की स्थितियाँ, दवाएं, प्रयोगशाला परिणाम और महत्वपूर्ण संकेत होते हैं।

<!-- visual:cta-longitudinal -->

## संबंधित

- [FHIR के साथ व्यक्तिगत स्वास्थ्य रिकॉर्ड (PHR) ऐप](https://developers.anpheros.com/hi/guides/personal-health-record-app): एक वास्तविक ऐप में टाइमलाइन
- [मेडिकल डेटा प्रोवेनेंस समझाया गया](https://developers.anpheros.com/hi/guides/medical-data-provenance)
- [स्वास्थ्य ऐप्स के लिए रोगी सहमति प्लेटफ़ॉर्म](https://developers.anpheros.com/hi/guides/patient-consent-platform)
- [FHIR R4 का उपयोग करके मेडिकल रिकॉर्ड कैसे स्टोर करें](https://developers.anpheros.com/hi/guides/store-medical-records-fhir)
- [AI एजेंट और मेडिकल डेटा](https://developers.anpheros.com/hi/guides/ai-agents-medical-data): कॉन्टेक्स्ट एंडपॉइंट
- [वेबहूक्स](https://developers.anpheros.com/hi/guides/webhooks)