बाह्य अनुरोध क्रिया आपको बाह्य सेवाओं से जानकारी भेजने या अनुरोध करने, तथा फिर उनसे प्रतिक्रिया प्राप्त करने और उसे ग्राहकों के कस्टम फ़ील्ड में लिखने की अनुमति देती है।
नीचे हम "बाहरी अनुरोध" क्रिया का उपयोग करने के सबसे सरल परिदृश्य पर विचार करेंगे। यह परिदृश्य वास्तविकता से कोसों दूर है, लेकिन यह "बाहरी अनुरोध" के सेटअप चरणों और सभी कार्यक्षमताओं को दर्शाता है।
परिदृश्य और उसकी सेटिंग्स का विवरण
इस उदाहरण में, हम swapi.dev । यह स्टार वार्स फ़िल्म श्रृंखला के बारे में जानकारी संग्रहीत करता है: फ़िल्म के शीर्षक, पात्रों के नाम और उनकी विशेषताएँ, वाहनों, ग्रहों, जातियों आदि का विवरण।
दूसरे शब्दों में, यह सेवा स्टार वार्स ब्रह्मांड पर एक विकिपीडिया है।
पटकथा के मुख्य चरण
- ग्राहक बॉट में प्रवेश कर जाता है।
- बॉट ग्राहक आईडी के साथ swapi.dev सेवा को एक अनुरोध भेजता है।
- यह सेवा उस पात्र का विवरण लौटाती है जिसकी आईडी ग्राहक की आईडी के समान होती है।
- बॉट कस्टम फ़ील्ड में पात्र का नाम लिखता है और ग्राहक को यह मान प्रदर्शित करता है।
बॉट सेट अप करना
एक सरल बॉट श्रृंखला बनाएं:
- एक ब्लॉक "संदेश 1" जोड़ें.
- स्वागत पाठ लिखें.
- अगले चरण पर जाने के लिए एक बटन जोड़ें.
- एक ब्लॉक "संदेश 2" जोड़ें.
- उपयोगकर्ता की आईडी प्रदर्शित करें.
- इस आईडी का उपयोग करके, बाह्य सेवा अपने डेटाबेस में वर्ण ढूंढ लेगी।
- एक्शन 1 ब्लॉक जोड़ें.
- इस ब्लॉक में, "बाहरी अनुरोध" क्रिया चुनें। बाहरी अनुरोध सेटिंग्स नीचे वर्णित हैं।
- एक ब्लॉक "संदेश 3" जोड़ें.
- एक कस्टम फ़ील्ड आउटपुट करें जिसमें आप बाहरी सेवा से प्राप्त वर्ण का नाम लिखेंगे।
- सभी ब्लॉकों को कनेक्ट करें और आपको इस तरह का एक छोटा बॉट मिलेगा:
"बाहरी अनुरोध" सेट अप करना
- "एक्शन 1" ब्लॉक में "एक्सटर्नल क्वेरी" एक्शन जोड़ने के बाद, "एक्सटर्नल क्वेरी" एडिटिंग विंडो खोलने के लिए "पेंसिल" पर क्लिक करें। फिर आपको खुलने वाली विंडो में सब कुछ कॉन्फ़िगर करना होगा।
- अनुरोध URL दर्ज करें.
- swapi.dev सेवा के विवरण में, उस विधि जो चरित्र की विशेषताओं को वापस करेगी: https://swapi.dev/api/people/ 1 /
- पते को कॉपी करें और URL फ़ील्ड में पेस्ट करें.
- इस पते में, "1" वर्ण आईडी है। मान के बजाय, एक मैक्रो डालें जो स्वचालित रूप से ग्राहक की आंतरिक आईडी को प्रतिस्थापित कर देगा। ऐसा करने के लिए, <> और वांछित मैक्रो चुनें।
- अंतिम लिंक: https://swapi.dev/api/people/{%bh_user_id%}
- अनुरोध प्रकार का चयन करें.
- इस अनुरोध का प्रकार GET है। यह जानकारी बाहरी सेवा की वेबसाइट पर उसके API के विवरण के साथ उपलब्ध होनी चाहिए। "अनुरोध प्रकार" ड्रॉप-डाउन सूची में इस प्रकार का चयन करें।
- इस विधि में भरने के लिए कोई हेडर या बॉडी नहीं है, इसलिए अनुरोध का परीक्षण करने के लिए आगे बढ़ें।
- यह सुनिश्चित करने के लिए कि सब कुछ सही ढंग से काम करता है और सेवा सही प्रतिक्रिया लौटाती है, "प्रतिक्रिया" टैब पर जाएं या परीक्षण अनुरोध ।
- खुले हुए टैब में, आपको इस्तेमाल किए गए मैक्रोज़ का परीक्षण डेटा दिखाई देगा। डिफ़ॉल्ट मान "10" है। ज़रूरत पड़ने पर आप इसे बदल सकते हैं।
- परीक्षण शुरू करने के लिए, अनुरोध भेजें ।
- प्रतिक्रिया "200 OK" है, जिसका अर्थ है कि बाहरी सेवा ने आपका अनुरोध प्राप्त कर लिया है और सफलतापूर्वक प्रतिक्रिया दे दी है।
- विंडो के दाईं ओर, "प्रतिक्रिया बॉडी" अनुभाग में, आप देख सकते हैं कि आपके अनुरोध के जवाब में आपको क्या प्राप्त हुआ।
- आप "नाम" फ़ील्ड के मान में रुचि रखते हैं। यह वही है जो आप स्वचालित रूप से सब्सक्राइबर के कस्टम फ़ील्ड में लिखेंगे।
- प्रतिक्रिया मिलान सेट करें.
- प्रतिक्रिया मैपिंग आपको तर्क सेट करने की अनुमति देता है जो प्राप्त प्रतिक्रिया निकाय से आवश्यक फ़ील्ड का मान लेगा और इसे निर्दिष्ट ग्राहक कस्टम फ़ील्ड में लिख देगा।
- ऐसा करने के लिए, आपको 1) वह पथ निर्दिष्ट करना चाहिए जिसके द्वारा आपको प्रतिक्रिया निकाय में आवश्यक फ़ील्ड ढूंढना है (यहां और पढ़ें: लिंक ), 2) और उपयोगकर्ता फ़ील्ड जिसमें आपको मान सहेजने की आवश्यकता है।
- ऐसा करने के लिए, मैपिंग जोड़ें और दिखाई देने वाले फ़ील्ड भरें।
- JSON पथ मान "$.name" प्राप्त प्रतिक्रिया के मुख्य भाग से "name" फ़ील्ड का मान लौटाएगा। परीक्षण के उदाहरण में, मान "Obi-Wan Kenobi" था।
- अब आपने बाह्य अनुरोध सेट अप करना पूर्ण कर लिया है।
- सहेजें पर क्लिक करके इसकी सेटिंग्स को सहेजना सुनिश्चित करें ।
- सहेजें और बंद करें पर क्लिक करके खुले एक्शन 1 चरण के लिए सेटिंग्स को सहेजना सुनिश्चित करें ।
बाहरी अनुरोध के साथ बॉट का परीक्षण करना
- बॉट का परीक्षण शुरू करें.
- परिणामस्वरूप, आपको इस प्रकार के संदेशों की एक श्रृंखला प्राप्त होगी:
मैं डार्थ वेडर हूं, आप कौन हैं?
यदि आपको अपने प्रश्न का उत्तर नहीं मिला है, तो अपने खाते के अंदर चैट में हमसे पूछें या BotHelpSupportBot या hello@bothelp.io
मेलिंग, ऑटोफ़नल और चैटबॉट्स बॉटहेल्प बनाने के लिए प्लेटफ़ॉर्म की 14 दिनों की पूर्ण कार्यक्षमता प्राप्त करें।