हेल्थकेयर डेटा एपीआई: क्या देखें, और एक घंटे में पेशेंट रिकॉर्ड कैसे पढ़ें और लिखें

"हेल्थकेयर एपीआई" में बहुत सी अलग-अलग चीजें शामिल होती हैं: अस्पताल का HL7 v2 फ़ीड, राष्ट्रीय ई-प्रिस्क्रिप्शन सेवा, वियरेबल विक्रेता का एक्सपोर्ट, एक FHIR सर्वर। यदि आप कोई हेल्थ ऐप, क्लिनिक टूल या AI असिस्टेंट बना रहे हैं, तो आपको एक संकीर्ण चीज़ की आवश्यकता है: एक बैकएंड जो किसी मरीज़ का रिकॉर्ड एक मानक प्रारूप में रखता है, मरीज़ को यह तय करने देता है कि उसे कौन पढ़ सकता है, और आपको उस पर एक साफ़ एपीआई देता है। यह गाइड बताता है कि क्या देखना है और वास्तविक कॉलों के साथ दिखाता है कि Anpheros Platform पर पहला घंटा कैसा दिखता है।

डेवलपर्स के लिए तकनीकी संस्करण: हेल्थकेयर एपीआई · मेडिकल डेटा एपीआई developers.anpheros.com पर, अनुरोधों, प्रतिक्रियाओं और सीमाओं के साथ। यह पृष्ठ सरल भाषा वाला संस्करण है।

एक हेल्थकेयर डेटा एपीआई को क्या करना होता है

पांच चीजें एक उपयोगी हेल्थ-डेटा एपीआई को HTTP के साथ एक डेटाबेस से अलग करती हैं।

• एक मानक प्रारूप। HL7 FHIR R4 वह प्रारूप है जिसका उपयोग अस्पताल, राष्ट्रीय प्रणालियाँ और यूरोपीय संघ का स्वास्थ्य डेटा स्पेस करते हैं। FHIR में संग्रहीत रिकॉर्ड को किसी कस्टम ब्रिज के बिना अन्य सिस्टम द्वारा पढ़ा जा सकता है। एक मालिकाना JSON नहीं कर सकता।
• मरीज़ की सहमति एक प्रथम श्रेणी की वस्तु के रूप में। कौन क्या पढ़ सकता है, कब तक, जिसे रद्द किया जा सकता है, मरीज़ के लिए दृश्यमान। आपके अपने डेटाबेस में एक चेकबॉक्स नहीं।
• उत्पत्ति। हर मान बताता है कि उसे किसने लिखा है: मरीज़, एक चिकित्सक, एक उपकरण, एक आयात, एक व्युत्पन्न गणना। एक AI असिस्टेंट जो लैब परिणाम को स्व-रिपोर्ट किए गए अनुमान से अलग नहीं बता सकता, वह खतरनाक है।
• यथार्थवादी डेटा के साथ एक सैंडबॉक्स। आप वास्तविक मरीज़ों के साथ परीक्षण नहीं कर सकते, और आपको स्वयं छह महीने के इतिहास के साथ 30 सिंथेटिक मरीज़ों का आविष्कार करने की आवश्यकता नहीं होनी चाहिए।
• डेटा निवास जिसे आप नाम दे सकते हैं। यूरोपीय उपयोगकर्ताओं के लिए इसका मतलब है कि सर्वर यूरोपीय संघ में, GDPR के तहत, डेटा प्रोसेसिंग समझौते के साथ हैं।

दो तरीके: REST और FHIR, एक ही डेटा

Anpheros Platform एक ही रिकॉर्ड को दो बार उजागर करता है। उत्पाद कोड के लिए एक सरल REST API (/v1), और किसी भी चीज़ के लिए जो स्वास्थ्य प्रणाली के बाकी हिस्सों से बात करनी है, उसके लिए सख्त FHIR R4 (/fhir/R4)। आईडी दोनों में समान हैं; हर v1 ऑब्जेक्ट अपने fhir संदर्भ को वहन करता है।

export BASE=https://platform.anpheros.com
export KEY=sk_test_…

# वे मरीज़ जिन्हें आपका प्रोजेक्ट देख सकता है
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# लैब परिणाम, सबसे नए पहले
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# सक्रिय दवाएं
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# सब कुछ एक टाइमलाइन पर
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# वही डेटा, सख्त FHIR
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

इन कॉलों के पीछे 26 FHIR संसाधन प्रकार (Patient, Observation, Condition, MedicationStatement, AllergyIntolerance, Immunization, DocumentReference, Encounter, Consent, Provenance और अधिक) हैं, जिन्हें मापों के लिए LOINC, स्थितियों के लिए ICD-10 और दवाओं के लिए ATC के साथ कोडित किया गया है।

एक कुंजी प्राप्त करने में एक मिनट लगता है

सैंडबॉक्स स्वयं-सेवा और मुफ़्त है। platform.anpheros.com/dashboard पर डैशबोर्ड में साइन इन करें, एक सैंडबॉक्स कुंजी प्राप्त करें दबाएं, और आपके पास एक संगठन, एक सैंडबॉक्स प्रोजेक्ट और एक sk_test_… कुंजी होगी। प्रोजेक्ट में 30 सिंथेटिक मरीज़ों की अपनी प्रतिलिपि आती है: वयस्क, बच्चे और यूरोपीय संघ भर के वृद्ध लोग, छह महीने से अधिक की स्थितियों, दवाओं, एलर्जी, लैब परिणामों और महत्वपूर्ण संकेतों के साथ। कुछ भी बदलें या हटाएं; एक रीसेट उन्हें वापस ले आता है।

उत्पादन कुंजियाँ (sk_live_…) सत्यापित संगठनों को हस्ताक्षरित डेटा प्रोसेसिंग समझौते के साथ मिलती हैं। सैंडबॉक्स और उत्पादन अलग-अलग डेटाबेस हैं: एक सैंडबॉक्स कुंजी शारीरिक रूप से वास्तविक मरीज़ तक नहीं पहुँच सकती है।

बॉक्स में और क्या है

• OAuth 2.1 PKCE के साथ और SMART on FHIR स्टैंडअलोन लॉन्च, ताकि कोई ऐप किसी व्यक्ति से उसके अपने रिकॉर्ड तक पहुँच के लिए पूछ सके।
• स्कोप, समाप्ति और निरस्तीकरण के साथ सहमति, और एक एक्सेस लॉग जिसे मरीज़ पढ़ सकता है।
• हस्ताक्षरित वेबहुक (HMAC-SHA256, बैकऑफ़ के साथ पुनः प्रयास किया गया) resource.created, consent.granted, consent.revoked, document.finalized के लिए।
• एक AI संदर्भ एपीआई जो एक टोकन बजट के भीतर मरीज़ के सारांश को उत्पत्ति लेबल के साथ बनाता है।
• CSV, HL7 v2 ORU^R01 या JSON से लैब रिपोर्ट आयात, LOINC में मैप किया गया।
• अंतर्राष्ट्रीय रोगी सारांश ($summary) और QR द्वारा साझा करने के लिए SMART Health Links।
• Dart और TypeScript के लिए SDKs, /docs पर एक OpenAPI संदर्भ और /fhir/R4/metadata पर एक CapabilityStatement।

प्रतिक्रियाओं के साथ पूरा वॉकथ्रू developers.anpheros.com/guides/first-hour पर उपलब्ध है।

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

क्या आज शुरू करने के लिए कोई मुफ़्त हेल्थकेयर एपीआई है?

हाँ। Anpheros सैंडबॉक्स मुफ़्त और स्वयं-सेवा है: साइन इन करें, एक कुंजी प्राप्त करें, और आपके पास पढ़ने और लिखने के लिए 30 सिंथेटिक मरीज़ हैं। सीमाएं प्रति प्रोजेक्ट 10,000 संसाधन लेखन प्रति दिन, 100 मरीज़ और 250 MB दस्तावेज़ हैं।

REST या FHIR, मुझे किसका उपयोग करना चाहिए?

अपने स्वयं के उत्पाद कोड के लिए /v1 का उपयोग करें: यह सरल है और सादा JSON लौटाता है। /fhir/R4 का उपयोग तब करें जब किसी अन्य सिस्टम को डेटा पढ़ने की आवश्यकता हो, जब आपको FHIR खोज, _history, $everything या $summary की आवश्यकता हो, या जब कोई प्रमाणन इसकी मांग करे। दोनों एक ही रिकॉर्ड देखते हैं।

मरीज़ की सहमति कैसे संभाली जाती है?

एक व्यक्ति OAuth के माध्यम से अपने रिकॉर्ड तक पहुँच के लिए एक एप्लिकेशन को अनुमति देता है, स्कोप और अवधि (30, 90, 180 या 365 दिन) चुनता है। अनुमति को किसी भी समय रद्द किया जा सकता है, और मरीज़ एक्सेस लॉग में हर रीड को देखता है। सहमति मॉडल में विवरण।

डेटा कहाँ होस्ट किया जाता है?

यूरोपीय संघ में (Cloud Run, europe-west4), हर राइट पर उत्पत्ति और संस्करण इतिहास के साथ। उत्पादन उपयोग के लिए एक हस्ताक्षरित डेटा प्रोसेसिंग समझौते की आवश्यकता होती है।

उत्पादन की लागत क्या है?

उत्पादन 2,500 संग्रहीत मरीज़ों के लिए €49 प्रति माह से शुरू होता है, जिसमें पहला महीना मुफ़्त है; बड़े प्लान €199 और €799 प्रति माह हैं। सैंडबॉक्स मुफ़्त रहता है। मूल्य निर्धारण देखें।

क्या यह AI एजेंटों के साथ काम करता है?

हाँ। उत्पत्ति लेबल और एक टोकन बजट के साथ एक AI संदर्भ एपीआई है, और platform.anpheros.com/mcp पर एक MCP सर्वर है जिससे कोई भी MCP-सक्षम सहायक कनेक्ट हो सकता है। AI मेडिकल सहायकों के साथ EMR एकीकरण देखें।