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

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

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

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

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

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

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

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

प्रॉक्सी की जांच की जा रही है

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

• ORG उस Edge संगठन का नाम है जिसमें आपने प्रॉक्सी बनाया है.
• ENV वह एनवायरमेंट है जिसमें प्रॉक्सी को डिप्लॉय किया जाता है.
• डोमेन आपके इस्तेमाल किए जा रहे 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 to SOAP से REST" में जोड़कर, किसी एसओएपी सेवा को प्रॉक्सी किया जाता है, तो Edge अपने-आप OpenAPI स्पेसिफ़िकेशन जनरेट करता है. आपके पास एपीआई के लिए दस्तावेज़ जनरेट करने के लिए, OpenAPI स्पेसिफ़िकेशन का इस्तेमाल करने का विकल्प होता है.

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

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

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

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

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

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

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

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

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

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