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

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

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

आपको किन चीज़ों की ज़रूरत होगी

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

प्रॉक्सी बनाई जा रही है

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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