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

रोगी की सहमति के साथ हेल्थकेयर API

OAuth 2.1 स्कोप और अवधि के माध्यम से रोगी द्वारा रिकॉर्ड तक पहुंच कैसे दी जाती है, लॉग की जाती है और वापस ली जा सकती है, यह एप्लिकेशन के डिज़ाइन में क्या बदलता है, और जोड़ीदार आईडी अनुप्रयोगों को अलग कैसे रखती है।

रोगी की सहमति के साथ एक हेल्थकेयर API वह है जहाँ किसी रिकॉर्ड तक पहुँच रोगी द्वारा, किसी उद्देश्य के लिए, किसी समय के लिए प्रदान की जाती है, और रोगी द्वारा देखी और वापस ली जा सकती है, बजाय इसके कि डेटा रखने वाले संगठन द्वारा एक बार तय किया जाए। Anpheros में, सहमति कोई ऐसा फ़ील्ड नहीं है जिसे आप सेट करते हैं; यह वह तंत्र है जिसके माध्यम से कोई एप्लिकेशन किसी रिकॉर्ड तक पहुँचता है। यह गाइड बताती है कि यह डेवलपर के लिए कैसे काम करता है और यह किसी एप्लिकेशन के डिज़ाइन में क्या बदलाव लाता है।

रिकॉर्ड तक पहुँचने के दो तरीके

	संगठन पहुँच	रोगी-प्रदत्त पहुँच
कौन अधिकृत करता है	आपका संगठन, एक API कुंजी के माध्यम से	रोगी, एक OAuth 2.1 सहमति स्क्रीन के माध्यम से
विशिष्ट उपयोग	एक क्लिनिक या प्रयोगशाला परिणाम लिख रही है, आपके अपने ऐप अपने उपयोगकर्ताओं की ओर से लिख रहे हैं	एक तृतीय-पक्ष ऐप, एक AI सहायक, एक डॉक्टर का उपकरण, एक परिवार का सदस्य
दायरा	वे रोगी जिन्हें आपके संगठन ने बनाया है या जो इसे साझा किए गए थे	वे दायरे जिन्हें रोगी ने स्वीकार किया (`patient/Observation.read`, …)
अवधि	जब तक कुंजी मान्य है	वह अवधि जो रोगी ने चुनी है; नवीकरणीय, प्रतिसंहरणीय
रोगी के लिए दृश्यमान	हाँ, एक्सेस लॉग में	हाँ, वापस लेने की क्षमता के साथ

दोनों रास्ते एक ही API और एक ही FHIR रिकॉर्ड से होकर गुजरते हैं। अंतर यह है कि दरवाजे की चाबी किसके पास है।

सहमति प्रवाह, चरण दर चरण

आपका एप्लिकेशन उन स्कोप्स के साथ जिन्हें उसकी आवश्यकता है और सादे भाषा में एक कारण के साथ मरीज़ को Anpheros प्राधिकरण एंडपॉइंट पर भेजता है।
मरीज़ देखता है कि आप क्या मांग रहे हैं, एक अवधि चुनता है और स्वीकार या अस्वीकार करता है। स्क्रीन मरीज़ की भाषा में होती है।
आपको उन स्कोप्स और उस मरीज़ तक सीमित एक एक्सेस टोकन प्राप्त होता है। टोकन अल्पकालिक होते हैं; रीफ़्रेश टोकन सहमति जितनी देर तक चलते हैं।
उस टोकन के साथ हर रीड और राइट को आपके एप्लिकेशन के नाम के साथ लॉग किया जाता है। मरीज़ अपने ऐप में लॉग देखता है।
यदि मरीज़ सहमति वापस ले लेता है, तो अगला अनुरोध एक स्पष्ट त्रुटि के साथ विफल हो जाता है। आपको एक वेबहुक प्राप्त होता है ताकि आप सफ़ाई कर सकें।

यह प्रवाह PKCE और SMART on FHIR स्कोप्स के साथ मानक OAuth 2.1 है, इसलिए मौजूदा लाइब्रेरी काम करती हैं। प्रमाणीकरण और OAuth गाइड में सटीक पैरामीटर हैं और सहमति और एक्सेस मॉडल में इसके पीछे के नियम हैं।

आपके एप्लिकेशन में क्या बदलता है

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

ऐसे पहचानकर्ता जो लीक न हों

प्रत्येक एप्लिकेशन एक रोगी को एक जोड़ीदार पहचानकर्ता (pairwise identifier) के तहत देखता है: एक ही व्यक्ति की आपके एप्लिकेशन में एक अलग आईडी होगी और किसी अन्य एप्लिकेशन में एक अलग आईडी होगी। दो एप्लिकेशन रोगी की सहमति के बिना किसी व्यक्ति के बारे में अपने डेटा को जोड़ नहीं सकते हैं, भले ही दोनों Anpheros पर बने हों। आपके कोड के लिए यह अदृश्य है; रोगी के लिए यह सहमति और औपचारिकता के बीच का अंतर है।

परिवार और देखभाल करने वाले

सहमति उन लोगों तक विस्तारित होती है जो दूसरों के लिए रिकॉर्ड प्रबंधित करते हैं: एक बच्चे के लिए माता-पिता, एक बुजुर्ग माता-पिता के लिए वयस्क बच्चा। रिकॉर्ड उसी खाते के साथ रहता है जिसने इसे बनाया है; अन्य खातों को पहुंच प्राप्त होती है, जिसे वापस लिया जा सकता है। आपका एप्लिकेशन उसी सहमति तंत्र को देखता है, जिसमें देखभाल करने वाला वह व्यक्ति होता है जो स्वीकार करता है।