एसओएपी सेवा को प्रॉक्सी करें

इस ट्यूटोरियल में, एसओएपी पर आधारित वेब के सामने Edge एपीआई प्रॉक्सी डालने का तरीका बताया गया है सेवा.

इस ट्यूटोरियल में बताया गया है कि एसओएपी पर आधारित, नए RESTful API को जनरेट करने का तरीका सेवा. हालांकि, यहां इस बारे में ज़्यादा जानकारी नहीं दी गई है, लेकिन पास-थ्रू प्रॉक्सी भी जनरेट की जा सकती है जो एसओएपी पेलोड को स्वीकार करता है और उसे बैकएंड सेवा को भेजता है.

आपको इनकी ज़रूरत होगी

• Apigee Edge खाता. अगर आपके पास अब तक कोई खाता नहीं है, तो निर्देशों की मदद से साइन अप करें एक Apigee बनाना Edge खाता.

प्रॉक्सी बनाना

यहां पर, Edge की प्रॉक्सी जनरेट की जा सकती है, जो SOAP सेवा के सामने होगी. SOAP API प्रॉक्सी दो तरह की होती हैं:

• REST-SOAP-REST प्रॉक्सी टाइप, अनुवाद के साथ नया RESTful एपीआई जनरेट करता है SOAP के लिए लेयर चुनें. क्लाइंट इसे क्वेरी पास करते हुए, अन्य RESTful सेवाओं की तरह कॉल करते हैं ऐसे पैरामीटर जो बैकएंड सेवा के लिए ज़रूरी हैं. Edge इसे SOAP पेलोड में बदल देता है उम्मीद के मुताबिक है.
• पास-थ्रू प्रॉक्सी प्रॉक्सी टाइप की मदद से, क्लाइंट आसानी से एसओएपी पेलोड पास कर सकते हैं. इस तरीके से, SOAP सेवा कॉल को Edge मैनेजमेंट की सुविधाओं का फ़ायदा मिलता है.

प्रॉक्सी की जांच करना

आपने जो प्रॉक्सी बनाया है उसे आज़माने के लिए, कोई कमांड प्रॉम्प्ट खोलें और cURL का इस्तेमाल करें. निर्देश लिखें जहां:

• ORG उस Edge संगठन का नाम होता है जिसमें आपने प्रॉक्सी बनाया है.
• ENV वह एनवायरमेंट है जिसमें प्रॉक्सी को डिप्लॉय किया जाता है.
• DOMAIN, आपके इस्तेमाल किए जा रहे Edge इंस्टेंस से मेल खाता है.

curl "https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

उदाहरण के लिए, अगर आपका संगठन docfood है, तो एनवायरमेंट test है, और आप Edge एंटरप्राइज़ क्लाउड का इस्तेमाल कर रहे हैं, तो आपको शामिल करें:

curl "https://docfood-test.apigee.net/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

अगर आपने StockSymbol क्वेरी पैरामीटर के लिए GOOG डाला है, तो आपको यह मिलना चाहिए Alphabet Inc. क्लास सी के स्टॉक की मौजूदा कीमत. उदाहरण के लिए:

{  
   "GetQuoteResponse":{  
      "GetQuoteResult":{  
         "StockSymbol":"GOOG",
         "LastTradeAmount":819.55,
         "LastTradeDateTime":"2017-02-13T14:33:00",
         "StockChange":5.88,
         "OpenAmount":816.0,
         "DayHigh":820.96,
         "DayLow":815.49,
         "StockVolume":785064,
         "PrevCls":813.67,
         "ChangePercent":"+0.72%",
         "FiftyTwoWeekRange":"663.28 - 841.95",
         "EarnPerShare":27.88,
         "PE":29.4,
         "CompanyName":"Alphabet Inc.",
         "QuoteError":false
      }
   }
}

अपने-आप जनरेट होने वाला OpenAPI पाएं खास जानकारी

जब "REST से SOAP से REST" का इस्तेमाल करके किसी एसओएपी सेवा को प्रॉक्सी किया जाता है, Edge अपने-आप जनरेट होता है OpenAPI की खास बातें. Google आपके यूआरएल पैरामीटर को कैसे इस्तेमाल करेगा, यह तय करने के लिए OpenAPI spec, ताकि API के लिए एपीआई दस्तावेज़ बनाया जा सके.

OpenAPI स्पेक्ट पाने के लिए, बस इस यूआरएल पर जाएं:

curl https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/openapi.json

अतिरिक्त क्रेडिट: कैसे क्या आपको पता चलता है कि किस रिसॉर्स, वर्ब, और क्वेरी पैरामीटर का इस्तेमाल करना चाहिए?

टेस्ट एपीआई कॉल में, आपने अपने cURL कॉल में एक खास संसाधन और क्वेरी पैरामीटर का इस्तेमाल किया एसओएपी सेवा से लिंक करना चाहते हैं. लेकिन, आपको खुद इसका पता कैसे चलेगा?

संसाधन और क्रिया

प्रॉक्सी बनाते समय, एपीआई प्रॉक्सी विज़र्ड में आपने देखा कि एसओएपी कैसे काम करता है एपीआई की क्रियाओं और संसाधनों से मैप करेगा. लेकिन अगर आपने उन्हें नहीं लिखा है, तो उसे तो प्रॉक्सी बनाने के बाद पता लगाएं.

API प्रॉक्सी के डेवलप करें टैब पर, बाएं नेविगेटर पैनल में आपको प्रॉक्सी एंडपॉइंट के तहत फ़्लो की सूची देखें. अपनी पसंद के फ़्लो पर क्लिक करें. उदाहरण के लिए, GetQuote फ़्लो एक अच्छा विकल्प है. फिर कोड पैनल में एक्सएमएल देखें, यह <Condition> में फ़्लो के लिए, रिसॉर्स पाथ और क्रिया को दिखाता है एलिमेंट: /quote और GET.

क्वेरी पैरामीटर

GetQuote फ़्लो चुनने के बाद, ग्राफ़िकल में पहली नीति पर क्लिक करें फ़्लो व्यू चुनें. यह ऐसी वैरिएबल एक्सट्रैक्ट करने की नीति होनी चाहिए जो इस तरह के क्वेरी पैरामीटर को कैप्चर करती हो: पास होना अपेक्षित है: StockSymbol और LicenseKey. (अगर किसी वेबसाइट या ऐप्लिकेशन पर खोजते हैं, तो यह आपको बताता है कि LicenseKey के लिए क्या पास करना है.

कैप्चर किए गए क्वेरी पैरामीटर, वैरिएबल के रूप में सेव किए जाते हैं और अगली नीति इनका इस्तेमाल इन कामों के लिए करती है एसओएपी मैसेज बनाएं.