मेडलाइनप्लस कनेक्ट: वेब सेवा
विषय
- वेब सेवा अवलोकन
- आउटपुट पैरामीटर्स
- निदान के लिए अनुरोध (समस्या) कोड
- वैकल्पिक पैरामीटर
- समस्या कोड अनुरोधों के जवाब में चयनित परमाणु तत्वों (या JSON ऑब्जेक्ट्स) का विवरण
- समस्या कोड के अनुरोधों के उदाहरण
- संबंधित सेवाएं और फ़ाइलें
- दवा की जानकारी के लिए अनुरोध
- वैकल्पिक पैरामीटर
- दवा अनुरोधों के जवाब में चयनित परमाणु तत्वों (या JSON ऑब्जेक्ट्स) का विवरण
- ड्रग कोड के अनुरोधों के उदाहरण
- लैब टेस्ट सूचना के लिए अनुरोध
- वैकल्पिक पैरामीटर
- लैब टेस्ट अनुरोधों के जवाब में चयनित परमाणु तत्वों (या JSON ऑब्जेक्ट्स) का विवरण
- लैब टेस्ट के लिए अनुरोध के उदाहरण
- स्वीकार्य उपयोग नीति
- अधिक जानकारी
मेडलाइनप्लस कनेक्ट वेब एप्लिकेशन या वेब सेवा के रूप में उपलब्ध है। वेब सेवा को लागू करने के लिए तकनीकी विवरण नीचे दिए गए हैं, जो निम्न के आधार पर अनुरोधों का जवाब देते हैं:
मेडलाइनप्लस कनेक्ट द्वारा लौटाए गए डेटा को लिंक करने और प्रदर्शित करने के लिए आपका स्वागत है। आप अपनी साइट पर मेडलाइनप्लस पृष्ठों की प्रतिलिपि नहीं बना सकते। यदि आप मेडलाइनप्लस कनेक्ट वेब सेवा के डेटा का उपयोग करते हैं, तो कृपया इंगित करें कि जानकारी मेडलाइनप्लस.जीओवी से है, लेकिन मेडलाइनप्लस लोगो का उपयोग न करें या अन्यथा यह संकेत दें कि मेडलाइनप्लस आपके विशेष उत्पाद का समर्थन करता है। आगे के मार्गदर्शन के लिए कृपया एनएलएम का एपीआई पेज देखें। इस सेवा के बाहर मेडलाइनप्लस सामग्री से कैसे लिंक करें, इस बारे में अधिक जानकारी के लिए, कृपया लिंक करने पर हमारे दिशानिर्देश और निर्देश देखें।
यदि आप मेडलाइनप्लस कनेक्ट का उपयोग करने का निर्णय लेते हैं, तो अपने सहयोगियों के साथ विकास और विचारों का आदान-प्रदान करने के लिए ईमेल सूची में साइन अप करें। कृपया हमें बताएं कि क्या आप हमसे संपर्क करके मेडलाइनप्लस कनेक्ट को लागू करते हैं।
वेब सेवा अवलोकन
वेब सेवा अनुरोधों के लिए पैरामीटर HL7 प्रसंग-जागरूक ज्ञान पुनर्प्राप्ति (इन्फोबटन) ज्ञान अनुरोध URL-आधारित कार्यान्वयन मार्गदर्शिका के अनुरूप हैं। आरईएसटी-आधारित प्रतिक्रिया एचएल7 कॉन्टेक्स्ट-अवेयर नॉलेज रिट्रीवल (इन्फोबटन) सर्विस-ओरिएंटेड आर्किटेक्चर इम्प्लीमेंटेशन गाइड के अनुरूप है। अनुरोध का आउटपुट एटम फ़ीड प्रारूप, JSON, या JSONP में XML हो सकता है।
अनुरोध की संरचना इंगित करती है कि आप किस प्रकार का कोड भेज रहे हैं। सभी मामलों में, वेब सेवा का आधार URL है: https://connect.medlineplus.gov/service
मेडलाइनप्लस कनेक्ट HTTPS कनेक्शन का उपयोग करता है। HTTP अनुरोध स्वीकार नहीं किए जाएंगे और HTTP का उपयोग करने वाले मौजूदा कार्यान्वयन HTTPS में अपडेट होने चाहिए।
आउटपुट पैरामीटर्स
ये पैरामीटर वैकल्पिक हैं। यदि आप उन्हें छोड़ देते हैं, तो डिफ़ॉल्ट प्रतिक्रिया एक्सएमएल प्रारूप में अंग्रेजी जानकारी है।
भाषा: हिन्दी
पहचानें कि क्या आप चाहते हैं कि प्रतिक्रिया अंग्रेजी या स्पेनिश में हो। यदि निर्दिष्ट नहीं है तो मेडलाइनप्लस कनेक्ट मान लेगा कि अंग्रेजी भाषा है।
यदि आप चाहते हैं कि समस्या कोड लुकअप की प्रतिक्रिया स्पेनिश में हो, तो इसका उपयोग करें: infoRecipient.languageCode.c=es
(= एसपी भी स्वीकार किया गया)
अंग्रेजी निर्दिष्ट करने के लिए, निम्नलिखित का उपयोग करें: infoRecipient.languageCode.c=hi
प्रारूप
पहचानें कि क्या आप चाहते हैं कि प्रतिक्रिया प्रारूप XML, JSON या JSONP हो। एक्सएमएल डिफ़ॉल्ट है।
- JSON का अनुरोध करने के लिए, उपयोग करें:
- नॉलेज रिस्पॉन्स टाइप = एप्लिकेशन/जेसन
- JSONP के लिए, उपयोग करें:
- knowledgeResponseType=application/javascript&callback=CallbackFunction जहां CallbackFunction एक ऐसा नाम है जिसे आप कॉल बैक फंक्शन देते हैं।
- एक्सएमएल में प्रतिक्रिया के लिए, उपयोग करें:
- नॉलेज रिस्पॉन्स टाइप = टेक्स्ट/एक्सएमएल या नॉलेज रिस्पॉन्स टाइप पैरामीटर को अनुरोध से बाहर कर दें।
निदान के लिए अनुरोध (समस्या) कोड
एक समस्या कोड के लिए, मेडलाइनप्लस कनेक्ट मेडलाइनप्लस स्वास्थ्य विषय पृष्ठों, आनुवंशिकी पृष्ठों, या अन्य एनआईएच संस्थानों के पृष्ठों से लिंक और जानकारी लौटाएगा।
मेडलाइनप्लस कनेक्ट निम्नलिखित लौटाएगा:
प्रत्येक कोड के लिए हमेशा एक मैच नहीं हो सकता है। उन मामलों में, मेडलाइनप्लस कनेक्ट एक शून्य प्रतिक्रिया देगा।
सेवा का आधार URL है: https://connect.medlineplus.gov/service
इस सेवा के किसी भी प्रश्न के लिए दो आवश्यक पैरामीटर हैं:
- कोड सिस्टम
उस समस्या कोड प्रणाली की पहचान करें जिसका आप उपयोग कर रहे हैं।- ICD-10-CM उपयोग के लिए:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.90
- ICD-9-CM उपयोग के लिए:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.103
- SNOMED CT उपयोग के लिए:
- mainSearchCriteria.v.cs=2.16.840.11.113883.6.96
- कोड
उस वास्तविक कोड की पहचान करें जिसे आप देखने का प्रयास कर रहे हैं:
mainSearchCriteria.v.c=250.33
वैकल्पिक पैरामीटर
कोड शीर्षक
आप समस्या कोड का नाम/शीर्षक भी पहचान सकते हैं। हालांकि, यह जानकारी प्रतिक्रिया को प्रभावित नहीं करती है (मेडलाइनप्लस कनेक्ट वेब एप्लिकेशन के विपरीत जहां नाम/शीर्षक जानकारी का उपयोग किया जा सकता है)। mainSearchCriteria.v.dn=डायबिटीज मेलिटस अन्य कोमा टाइप 1 अनियंत्रित के साथ भाषा और आउटपुट स्वरूपों के विवरण के लिए आउटपुट पैरामीटर्स पर उपरोक्त अनुभाग देखें।
समस्या कोड अनुरोधों के जवाब में चयनित परमाणु तत्वों (या JSON ऑब्जेक्ट्स) का विवरण
तत्त्व | कक्षा नोड | विवरण |
---|---|---|
शीर्षक | मिलान किए गए मेडलाइनप्लस स्वास्थ्य विषय पृष्ठ या जीएचआर पृष्ठ का शीर्षक | |
संपर्क | मेल खाने वाले मेडलाइनप्लस स्वास्थ्य विषय पृष्ठ या जीएचआर पृष्ठ के लिए URL | |
सारांश | स्वास्थ्य विषय के लिए पूर्ण सारांश। इसमें अन्य प्रासंगिक स्वास्थ्य विषयों के लिए एम्बेडेड लिंक और बुलेट और पैराग्राफ रिक्ति सहित सभी स्वरूपण शामिल हैं। सारांश HTML में है। GHR पृष्ठों के लिए, पूर्ण पृष्ठ का पहला खंड प्रदान किया गया है। | |
सारांश | विषय के लिए समानार्थी। इन्हें स्वास्थ्य विषय पृष्ठ पर "इसे भी कहा जाता है" के रूप में संदर्भित किया जाता है। सभी विषयों में "इसे भी कहा जाता है" शब्द नहीं होते हैं। | |
सारांश | सारांश पाठ के लिए एट्रिब्यूशन पावती, यदि सारांश का अधिकांश भाग किसी अन्य संघीय एजेंसी से था। सभी सारांशों में एक विशेषता नहीं होती है। मेडलाइनप्लस के लिए असंबद्ध पाठ मूल है। | |
सारांश | विषय से जुड़े चयनित लिंक। इसमें पृष्ठ का नाम, URL और संबद्ध संगठन (जब लागू हो) शामिल हैं। लिंक बुलेटेड सूची में स्वरूपित हैं। सभी विषयों में ये लिंक नहीं होते हैं। लिंक की संख्या शून्य से लेकर दर्जनों तक हो सकती है। |
समस्या कोड के अनुरोधों के उदाहरण
अन्य कोमा टाइप 1 अनियंत्रित, ICD-9 कोड 250.33 के साथ डायबिटीज मेलिटस के लिए एक स्पेनिश भाषी रोगी के लिए एक पूर्ण अनुरोध में निम्नलिखित URL पता होगा: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16 .840.1.113883.6.103&mainSearchCriteria.vc=250.33&mainSearchCriteria.v.dn=Diabetes%20mellitus%20with%20other%20coma%20type%201%20uncontrolled&informationRecipient.languageCode.c=es
एक ही निदान वाला रोगी लेकिन अनुरोधित प्रारूप JSON है और भाषा अंग्रेजी है: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.103&mainSearchCriteria.vc=250.33&knowledgeResponseType=application /जेसन
SNOMED CT कोड 41381004: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.vc=41381004&mainSearchCriteria.v.dn= का उपयोग करके "स्यूडोमोनास के कारण निमोनिया" का निदान किया गया रोगी निमोनिया%20देय%20to%20Pseudomonas%20%28disorder%29&informationRecipient.languageCode.c=hi
एक ही निदान वाला रोगी लेकिन अनुरोधित प्रारूप JSONP है: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.96&mainSearchCriteria.v.c=41381004&knowledgeResponseType=application/javascript&callback=CallbackFunction
संबंधित सेवाएं और फ़ाइलें
टेक्स्ट अनुरोधों के जवाब में मेडलाइनप्लस स्वास्थ्य विषय प्राप्त करने के लिए, समस्या कोड के विपरीत, मेडलाइनप्लस वेब सेवा की जांच करें। इसके अलावा, अगर आपको एक्सएमएल प्रारूप में मेडलाइनप्लस स्वास्थ्य विषयों के पूर्ण सेट की आवश्यकता है, तो हमारा एक्सएमएल फाइल पेज देखें।
दवा की जानकारी के लिए अनुरोध
मेडलाइनप्लस कनेक्ट आरएक्ससीयूआई प्राप्त करते समय सर्वोत्तम दवा सूचना मिलान प्रदान करता है। NDC कोड प्राप्त करने पर यह अच्छे परिणाम भी प्रदान करता है। मेडलाइनप्लस कनेक्ट अंग्रेजी या स्पेनिश में प्रतिक्रिया प्रदान कर सकता है।
अंग्रेजी दवा की जानकारी के अनुरोध के लिए, यदि आप एनडीसी या आरएक्ससीयूआई नहीं भेजते हैं या यदि हमें कोड के आधार पर कोई मिलान नहीं मिलता है, तो एप्लिकेशन उस टेक्स्ट स्ट्रिंग का उपयोग करेगा जिसे आप सर्वोत्तम दवा सूचना मिलान प्रदर्शित करने के लिए भेजते हैं। स्पैनिश दवा की जानकारी के अनुरोधों के लिए, मेडलाइनप्लस कनेक्ट केवल एनडीसी या आरएक्ससीयूआई का जवाब देता है और टेक्स्ट स्ट्रिंग्स का उपयोग नहीं करता है। अंग्रेजी में प्रतिक्रिया देना संभव है लेकिन स्पेनिश में कोई प्रतिक्रिया नहीं है।
मेडलाइनप्लस कनेक्ट वेब सेवा निम्नलिखित लौटाएगी:
एक दवा अनुरोध के लिए कई प्रतिक्रियाएं हो सकती हैं। प्रत्येक अनुरोध के लिए हमेशा एक मिलान नहीं हो सकता है। उन मामलों में, मेडलाइनप्लस कनेक्ट एक शून्य प्रतिक्रिया देगा।
दवा की जानकारी के अनुरोध के लिए, आधार URL है: https://connect.medlineplus.gov/service
अनुरोध भेजने के लिए, जानकारी के इन अंशों को शामिल करें:
- कोड सिस्टम
आपके द्वारा भेजे जा रहे दवा कोड के प्रकार की पहचान करें। (अंग्रेजी और स्पेनिश के लिए आवश्यक)- RXCUI उपयोग के लिए:
- mainSearchCriteria.v.cs=2.16.840.11.113883.6.88
- एनडीसी उपयोग के लिए:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.69
- कोड
उस वास्तविक कोड की पहचान करें जिसे आप देखने का प्रयास कर रहे हैं। (अंग्रेजी के लिए पसंदीदा, स्पेनिश के लिए आवश्यक)
mainSearchCriteria.v.c=637188 - दवा का नाम
टेक्स्ट स्ट्रिंग के साथ दवा का नाम पहचानें। (अंग्रेजी के लिए वैकल्पिक, स्पेनिश के लिए उपयोग नहीं किया गया)
mainSearchCriteria.v.dn=Chantix 0.5 MG Oral Tablet
वैकल्पिक पैरामीटर
कोड शीर्षकअंग्रेजी जानकारी के लिए अनुरोध भेजते समय, आप दवा के नाम के वैकल्पिक पैरामीटर को शामिल कर सकते हैं। यह उपरोक्त खंड में विस्तृत है। mainSearchCriteria.v.dn=Chantix 0.5 MG Oral Tablet
भाषा और आउटपुट स्वरूपों के विवरण के लिए आउटपुट पैरामीटर्स पर उपरोक्त अनुभाग देखें।
दवा अनुरोधों के जवाब में चयनित परमाणु तत्वों (या JSON ऑब्जेक्ट्स) का विवरण
तत्त्व | विवरण |
---|---|
शीर्षक | मेल खाने वाले मेडलाइनप्लस दवा पृष्ठ के लिए शीर्षक |
संपर्क | मेल खाने वाले मेडलाइनप्लस दवा पृष्ठ का URL URL |
लेखक | दवा की जानकारी के लिए स्रोत एट्रिब्यूशन |
ड्रग कोड के अनुरोधों के उदाहरण
आपका दवा जानकारी अनुरोध निम्न में से एक जैसा दिखना चाहिए।
RXCUI द्वारा जानकारी का अनुरोध करने के लिए, आपका अनुरोध इस तरह दिखना चाहिए: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.88&mainSearchCriteria.vc=637188&mainSearchCriteria.v.dn=Chantix% 200.5%20MG%20मौखिक%20टैबलेट&सूचनाRecipient.languageCode.c=hi
स्पैनिश स्पीकर के लिए एनडीसी द्वारा जानकारी का अनुरोध करने के लिए, आपका अनुरोध इस तरह दिखना चाहिए: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.vc=00310-0751- 39&informationRecipient.languageCode.c=es
दवा कोड के बिना एक टेक्स्ट स्ट्रिंग भेजने के लिए, आपको अपनी क्वेरी को एनडीसी-प्रकार के अनुरोध के रूप में पहचानना होगा ताकि मेडलाइनप्लस कनेक्ट को पता चले कि आप दवा की जानकारी की तलाश कर रहे हैं। यह केवल अंग्रेजी अनुरोधों के लिए काम करेगा। आपका अनुरोध इस तरह दिख सकता है: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.69&mainSearchCriteria.v.dn=Chantix%200.5%20MG%20Oral%20Tablet&informationRecipient.languageCode.c =एन
लैब टेस्ट सूचना के लिए अनुरोध
मेडलाइनप्लस कनेक्ट एलओआईएनसी अनुरोध प्राप्त करते समय प्रयोगशाला परीक्षण जानकारी के लिए मिलान प्रदान करता है। सेवा अंग्रेजी या स्पेनिश में प्रतिक्रिया प्रदान कर सकती है।
मेडलाइनप्लस कनेक्ट वेब सेवा निम्नलिखित लौटाएगी:
प्रत्येक कोड के लिए हमेशा एक मैच नहीं हो सकता है। उन मामलों में, मेडलाइनप्लस कनेक्ट एक शून्य प्रतिक्रिया देगा।
सेवा का आधार URL है: https://connect.medlineplus.gov/service
इस सेवा के लिए किसी भी प्रयोगशाला परीक्षण क्वेरी के लिए ये दो आवश्यक पैरामीटर हैं:
- कोड सिस्टम
- पहचानें कि आप LOINC कोड सिस्टम का उपयोग कर रहे हैं। प्रयोग करें:
- mainSearchCriteria.v.cs=2.16.840.1.113883.6.1
- मेडलाइनप्लस कनेक्ट भी स्वीकार करेगा:
- mainSearchCriteria.v.cs=2.16.840.1.113883.11.79
- कोड
उस वास्तविक कोड की पहचान करें जिसे आप देखने का प्रयास कर रहे हैं:
mainSearchCriteria.v.c=3187-2
वैकल्पिक पैरामीटर
कोड शीर्षकआप लैब टेस्ट के नाम की पहचान भी कर सकते हैं। हालाँकि, यह जानकारी प्रतिक्रिया को प्रभावित नहीं करती है। mainSearchCriteria.v.dn=कारक IX परख
भाषा और आउटपुट स्वरूपों के विवरण के लिए आउटपुट पैरामीटर्स पर उपरोक्त अनुभाग देखें।
लैब टेस्ट अनुरोधों के जवाब में चयनित परमाणु तत्वों (या JSON ऑब्जेक्ट्स) का विवरण
तत्त्व | विवरण |
---|---|
शीर्षक | मेल खाने वाले मेडलाइनप्लस लैब टेस्ट पेज का शीर्षक |
संपर्क | मेल खाने वाले मेडलाइनप्लस लैब टेस्ट पेज के लिए यूआरएल |
सारांश | पृष्ठ सामग्री से स्निपेट |
लेखक | प्रयोगशाला परीक्षण सामग्री के लिए स्रोत एट्रिब्यूशन |
लैब टेस्ट के लिए अनुरोध के उदाहरण
अंग्रेजी बोलने वाले के लिए जानकारी का अनुरोध करने के लिए, आपका अनुरोध निम्न में से एक जैसा दिख सकता है: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria। v.dn=Factor%20IX%20assay&informationRecipient.languageCode.c=en https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c =एन
स्पैनिश स्पीकर के लिए जानकारी का अनुरोध करने के लिए, आपका अनुरोध निम्न में से एक जैसा दिख सकता है: https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&mainSearchCriteria। v.dn=Factor%20IX%20assay&informationRecipient.languageCode.c=es https://connect.medlineplus.gov/service?mainSearchCriteria.v.cs=2.16.840.1.113883.6.1&mainSearchCriteria.vc=3187-2&informationRecipient.languageCode.c =एस
स्वीकार्य उपयोग नीति
मेडलाइनप्लस सर्वर को ओवरलोड करने से बचने के लिए, एनएलएम के लिए आवश्यक है कि मेडलाइनप्लस कनेक्ट के उपयोगकर्ता प्रति आईपी पते पर प्रति मिनट 100 से अधिक अनुरोध न भेजें। इस सीमा से अधिक के अनुरोधों की सेवा नहीं की जाएगी, और सेवा को 300 सेकंड के लिए या अनुरोध दर सीमा से नीचे आने तक, जो भी बाद में आता है, बहाल नहीं किया जाएगा। आपके द्वारा Connect को भेजे जाने वाले अनुरोधों की संख्या को सीमित करने के लिए, NLM 12-24 घंटे की अवधि के लिए कैशिंग परिणामों की अनुशंसा करता है।
यह नीति यह सुनिश्चित करने के लिए है कि सेवा सभी उपयोगकर्ताओं के लिए उपलब्ध और सुलभ बनी रहे। यदि आपके पास एक विशिष्ट उपयोग मामला है जिसके लिए आपको मेडलाइनप्लस कनेक्ट को बड़ी संख्या में अनुरोध भेजने की आवश्यकता है, और इस प्रकार इस नीति में उल्लिखित अनुरोध दर सीमा से अधिक है, तो कृपया हमसे संपर्क करें। NLM स्टाफ आपके अनुरोध का मूल्यांकन करेगा और निर्धारित करेगा कि क्या कोई अपवाद दिया जा सकता है। कृपया मेडलाइनप्लस एक्सएमएल फाइलों के दस्तावेज की भी समीक्षा करें। इन एक्सएमएल फाइलों में संपूर्ण स्वास्थ्य विषय रिकॉर्ड होते हैं और मेडलाइनप्लस डेटा तक पहुंचने के वैकल्पिक तरीके के रूप में काम कर सकते हैं।