Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

हेल्थकेयर API: यह क्या है और यह कैसे काम करता है

Q: डेटा कहाँ संग्रहीत किया जाता है?

यूरोपीय संघ में: सेवा और इसके डेटाबेस Google Cloud europe-west4 (नीदरलैंड) में चलते हैं।

हेल्थकेयर API क्या है, एक कॉल कैसे काम करती है, क्या देखना है, और रोगी की सहमति, उत्पत्ति और यूरोपीय संघ होस्टिंग के साथ एक मुफ़्त FHIR R4 हेल्थकेयर API - उदाहरणों और अक्सर पूछे जाने वाले प्रश्नों के साथ।

एक हेल्थकेयर API एक प्रोग्रामेटिक इंटरफ़ेस है जिसके माध्यम से सॉफ़्टवेयर स्वास्थ्य डेटा — रोगी रिकॉर्ड, अवलोकन, निदान, दवाएं, दस्तावेज़ — पढ़ता और लिखता है, और जिसके माध्यम से उस डेटा तक पहुंच अधिकृत की जाती है। Anpheros Platform API एक रोगी-नियंत्रित HL7 FHIR R4 रिकॉर्ड पर एक हेल्थकेयर API है: एप्लिकेशन इसका उपयोग चिकित्सा डेटा संग्रहीत करने और पुनर्प्राप्त करने, रोगी की सहमति प्राप्त करने और परिवर्तनों की सूचना प्राप्त करने के लिए करते हैं।

एक हेल्थकेयर एपीआई कॉल कैसे काम करता है

चाहे विक्रेता कोई भी हो, एक हेल्थकेयर एपीआई कॉल उन्हीं जाँच बिंदुओं से गुजरता है: कौन कॉल कर रहा है, कौन सा मरीज़ और किस डेटा को वे छू सकते हैं, डेटा कहाँ संग्रहीत है, इसे किसने लिखा है, और किसे यह जानने की आवश्यकता है कि यह बदल गया है।

स्वास्थ्य API के प्रकार

प्रकार	क्या आदान-प्रदान करता है	विशिष्ट उपयोग
FHIR REST APIs	HTTP पर FHIR संसाधन (`GET /Observation?patient=…`)	नैदानिक डेटा विनिमय के लिए आधुनिक मानक
SMART on FHIR / OAuth	FHIR APIs के लिए प्राधिकरण	उपयोगकर्ता की अनुमति से किसी रिकॉर्ड तक पहुँचने के लिए तृतीय-पक्ष ऐप्स को सक्षम करना
HL7 v2 messaging	पाइप-सीमांकित संदेश (परिणामों के लिए `ORU^R01`, प्रवेश के लिए `ADT`)	प्रयोगशाला और अस्पताल प्रणालियाँ, अक्सर HTTP के बजाय इंटरफेस पर
Document exchange	नैदानिक दस्तावेज़ (PDF, CDA, FHIR दस्तावेज़ बंडल)	सारांश, डिस्चार्ज पत्र, रेफरल
Proprietary REST APIs	विक्रेता-विशिष्ट JSON	किसी एकल उत्पाद का अपना मोबाइल ऐप या एकीकरण

Anpheros पहले दो को अपने मूल के रूप में जोड़ता है, इनपुट के रूप में HL7 v2 प्रयोगशाला परिणाम स्वीकार करता है, मूल के साथ दस्तावेज़ संग्रहीत करता है और FHIR दस्तावेज़ बंडल (अंतर्राष्ट्रीय रोगी सारांश) उत्पन्न करता है। यह उन डेवलपर्स के लिए समान डेटा पर एक सरल REST API भी प्रदान करता है जो सीधे FHIR के साथ काम नहीं करना चाहते हैं।

स्वास्थ्य सेवा API में क्या देखना चाहिए

What to look for in a healthcare API — and how Anpheros answers

Standard data modelHL7 FHIR R4 with LOINC, ICD-10, ATC, UCUM

Patient-controlled accessOAuth 2.1 consent with scopes, expiry and revocation

ProvenanceAuthor, organisation and source on every write

HistoryEvery version kept; conditional updates with If-Match

Audit of readsEach read and write logged, visible to the patient

Safe retriesIdempotency-Key on POST; predictable errors

IsolationPairwise patient ids per application

Data residencyEuropean Union: Google Cloud europe-west4

इस पृष्ठ का बाकी हिस्सा दिखाता है कि ये प्रत्येक चीज़ Anpheros API में कैसे दिखाई देती है।

Anpheros API का संक्षिप्त अवलोकन

सतह	बेस पाथ	उद्देश्य
FHIR R4	`/fhir/R4`	26 संसाधन प्रकार; पढ़ना, खोजना, बनाना, अपडेट करना, हटाना, इतिहास, लेनदेन, `$everything`, `$summary`, `$validate`
REST v1	`/v1`	मरीज़, अवलोकन, स्थितियाँ, दवाएँ, दस्तावेज़, टाइमलाइन, प्रोवेनेंस, AI संदर्भ, लैब आयात, शब्दावली, वेबहुक
OAuth 2.1	`/oauth`	सहमति पृष्ठ, टोकन (PKCE), निरस्तीकरण, OpenID Connect कुंजियाँ
मरीज़ पक्ष	`/me`	किसी व्यक्ति के अपने रिकॉर्ड, किसके पास पहुँच है, पहुँच लॉग, निरस्त करें
डिस्कवरी	`/fhir/R4/metadata`, `/fhir/R4/.well-known/smart-configuration`, `/openapi.json`	API के मशीन-पठनीय विवरण

बेस URL: https://platform.anpheros.com। सैंडबॉक्स और प्रोडक्शन इसे साझा करते हैं; कुंजी डेटा प्लेन तय करती है।

प्रमाणीकरण

आपके सर्वर के लिए API कुंजियाँ (sk_test_…, sk_live_…); वे उन मरीज़ों को देखते हैं जिन्हें आपके प्रोजेक्ट ने बनाया है।
सहमति के तहत एक मरीज़ के लिए कार्य करने वाले एप्लिकेशन के लिए OAuth एक्सेस टोकन (at_…)।

curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"

सुरक्षित रूप से लिखना

POST अनुरोध Idempotency-Key स्वीकार करते हैं: समान कुंजी के साथ पुनः प्रयास किया गया अनुरोध मूल प्रतिक्रिया देता है और कुछ भी नहीं बनाता है। प्रत्येक लेखन को एक Provenance मिलता है; लेखक प्रकार बॉडी (author_type) में या हेडर जैसे X-Anpheros-Author-Type, X-Anpheros-Source-System, X-Anpheros-Origin-Id और X-Anpheros-On-Behalf-Of में भेजा जाता है।

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": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'

त्रुटियाँ और सीमाएँ

FHIR एंडपॉइंट OperationOutcome के साथ उत्तर देते हैं; अन्य {"error": {"type", "message", "field"}} के साथ। प्रत्येक प्रतिक्रिया Anpheros-Request-Id ले जाती है। डिफ़ॉल्ट सीमा प्रति मिनट प्रति कुंजी और प्रति IP 600 अनुरोध है। त्रुटियाँ · सीमाएँ

घटनाएँ

resource.created, resource.updated, resource.deleted, consent.granted, consent.revoked, document.finalized और ping के लिए हस्ताक्षरित वेबहुक। वेबहुक

FHIR और REST v1 के बीच चयन

FHIR का उपयोग तब करें जब आप पहले से ही FHIR के साथ काम कर रहे हों, ऐसे संसाधन प्रकारों की आवश्यकता हो जो /v1 में शामिल नहीं हैं (उदाहरण के लिए Immunization, Procedure या CarePlan), या अन्य FHIR सिस्टम के साथ डेटा का आदान-प्रदान कर रहे हों। सामान्य मामलों के लिए फ्लैट JSON चाहने वाले एप्लिकेशन कोड के लिए REST v1 का उपयोग करें। दोनों समान आईडी के साथ समान संसाधनों को पढ़ते और लिखते हैं, इसलिए एक प्रोजेक्ट उन्हें मिला सकता है। Medical data API डेटा संचालन का विस्तार से वर्णन करता है।

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

हेल्थकेयर एपीआई क्या है?

एक प्रोग्रामेटिक इंटरफ़ेस जिसके माध्यम से सॉफ़्टवेयर स्वास्थ्य डेटा - रोगी रिकॉर्ड, अवलोकन, निदान, दवाएं और दस्तावेज़ - पढ़ता और लिखता है, और जिसके माध्यम से उस डेटा तक पहुंच अधिकृत की जाती है। आधुनिक हेल्थकेयर एपीआई डेटा के लिए HL7 FHIR R4 और प्राधिकरण के लिए OAuth 2.0 या 2.1 SMART on FHIR के साथ उपयोग करते हैं।

हेल्थकेयर एपीआई और FHIR एपीआई में क्या अंतर है?

FHIR एक मानक है जिसका पालन हेल्थकेयर एपीआई कर सकता है। एक FHIR एपीआई REST पर FHIR संसाधनों का आदान-प्रदान करता है; एक हेल्थकेयर एपीआई HL7 v2 संदेश, दस्तावेज़ या मालिकाना JSON भी स्वीकार कर सकता है। Anpheros एक FHIR R4 एपीआई और उसी डेटा पर एक सरल REST एपीआई प्रदान करता है।

क्या डेवलपर्स के लिए कोई मुफ्त हेल्थकेयर एपीआई है?

हाँ। Anpheros सैंडबॉक्स मुफ़्त और स्व-सेवा है: Google के साथ साइन इन करें, एक एपीआई कुंजी प्राप्त करें और FHIR R4 या REST पर 30 सिंथेटिक रोगियों के साथ काम करें। उत्पादन €99 प्रति माह से शुरू होता है, जिसमें पहला महीना मुफ़्त है।

मरीज़ हेल्थकेयर एपीआई को सहमति कैसे देते हैं?

OAuth 2.1 PKCE के साथ: एप्लिकेशन व्यक्ति को SMART on FHIR स्कोप के साथ एक सहमति पृष्ठ पर भेजता है; व्यक्ति चुनता है कि क्या साझा करना है और कब तक, एक्सेस लॉग देख सकता है और किसी भी समय एक्सेस रद्द कर सकता है।

डेटा कहाँ संग्रहीत किया जाता है?

यूरोपीय संघ में: सेवा और इसके डेटाबेस Google Cloud europe-west4 (नीदरलैंड) में चलते हैं।

मुझे कौन सा हेल्थकेयर एपीआई चुनना चाहिए?

डेटा मानक, कौन एक्सेस अधिकृत करता है, उत्पत्ति और ऑडिट, डेटा निवास, रिट्री और त्रुटियां कैसे व्यवहार करती हैं, और क्या आप मुफ्त में यथार्थवादी डेटा के साथ परीक्षण कर सकते हैं, इसकी तुलना करें। हेल्थकेयर एपीआई प्लेटफ़ॉर्म: इसमें क्या शामिल है और कैसे चुनें इन सभी को किसी भी विक्रेता से पूछने वाले प्रश्नों में बदल देता है।