আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য
আপনি কী শিখবেন
এই টিউটোরিয়ালের মাধ্যমে, আপনি এগুলি করতে শিখবেন:
- WSDL ফাইল থেকে Edge API প্রক্সি তৈরি করুন।
- RESTful SOAP প্রক্সি টাইপ ও পাস-থ্রু SOAP প্রক্সির মধ্যে পার্থক্য জানুন।
এই টিউটোরিয়ালে, আপনি কীভাবে 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 পেলোড সহজে পাস করতে দেয়। এটি Edge ম্যানেজমেন্ট ফিচারের সুবিধা নিয়ে SOAP পরিষেবা কল করার একটি উপায়।
Edge
Edge UI ব্যবহার করে SOAP পরিষেবার প্রক্সি করতে:
- apigee.com/edge লিঙ্কে গিয়ে সাইন-ইন করুন।
- বাঁদিকের নেভিগেশন বারে ডেভেলপ করুন > API প্রক্সি বিকল্প বেছে নিন।
- +প্রক্সি বিকল্পে ক্লিক করুন।
- SOAP পরিষেবা বিকল্পে ক্লিক করুন।
- প্রক্সি বিবরণ পৃষ্ঠায়, নিম্নলিখিত তথ্য লিখুন:
ফিল্ড বিবরণ WSDL সোর্স বেছে নিন: URL
URL লিখুন ফিল্ডে নিচে দেওয়া WSLD URL কপি করে পেস্ট করুন:
https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?wsdl
এখানে ক্লিক করুন: যাচাই করুন
Apigee Edge WSDL ফাইলটি পায় এবং SOAP পরিষেবা যেসব অপারেশন সাপোর্ট করে তার তালিকা খুঁজে পেতে এটি পড়ে।
নাম যেমন আছে তেমন রেখে দিন:
delayedstockquoteএটি হল আপনার তৈরি করা API প্রক্সির নাম।
বেস পাথ যেমন আছে তেমন রেখে দিন: /delayedstockquoteবিবরণ ঐচ্ছিকভাবে, একটি বিবরণ যোগ করুন, যেমন: স্টক কোট WSDL API প্রক্সি - পরবর্তী বিকল্পে ক্লিক করুন।
- সাধারণ নীতি পৃষ্ঠায়, নিরাপত্তা: অনুমোদন বিকল্পের মধ্যে, পাস থ্রু (কোনও অনুমোদন নেই) বিকল্প বেছে নিন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- WSDL অপারেশন পৃষ্ঠায়, এগুলি বেছে নিন: REST থেকে SOAP থেকে REST.
প্রক্সি ধরন বেছে নেওয়ার পরে, Edge সেইসব অপারেশনের তালিকা দেখায় যেগুলির জন্য এটি REST API পাথ তৈরি করবে। এই তালিকা আপনাকে WSDL-এ পাওয়া অপারেশনগুলির মধ্যে থেকে বেছে নিতে সাহায্য করে (যদি আপনার কাছে নির্দিষ্ট সেট থাকে যা আপনি খুঁজছেন)। এছাড়াও, লক্ষ্য করুন যে সারণীতে এমন রিসোর্স দেখানো হয়েছে যা ব্যাকএন্ড SOAP পরিষেবায় কল করার জন্য REST ক্লায়েন্ট ব্যবহার করতে পারে।
পৃষ্ঠায় অন্য সব বেছে নেওয়া বিকল্প যেমন আছে তেমনই রেখে দিন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- পরবর্তী বিকল্পে ক্লিক করে ভার্চুয়াল হোস্টের ডিফল্ট সেটিংয়ে সম্মতি জানান।
- সারসংক্ষেপ পৃষ্ঠায়, ঐচ্ছিক ডেপ্লয়মেন্টের অধীনে টেস্ট করুন এবং তৈরি ও ডেপ্লয় করুন বিকল্পে ক্লিক করুন।
Edge একটি RESTful API প্রক্সি তৈরি করে এবং
testএনভায়রনমেন্টে তা ডেপ্লয় করে। WSDL থেকে, এটি পরিষেবার সাপোর্ট করা অপারেশন, ইনপুট প্যারামিটার ইত্যাদি নির্ধারণ করে। প্রতিটি অপারেশনের জন্য কোন HTTP পদ্ধতি ব্যবহার করতে হবে তা Edge সাজেস্ট করে। সাধারণত, Edge অপারেশনকে GET অনুরোধে ট্রান্সলেট করে, যার ক্যাশে করা যায়। এছাড়াও, Edge ব্যাকএন্ড টার্গেট এন্ডপয়েন্ট সেট-আপ করে, যা প্রতিটি SOAP অপারেশনের জন্য আলাদা হতে পারে।আপনি যদি নতুন API প্রক্সি কাস্টমাইজ না করে থাকেন (এবং এই টিউটোরিয়ালে আপনাকে তা করতে হবে না), তাহলে এই প্রক্রিয়াটি এখানেই শেষ হয়ে যায়। আপনি নতুন API প্রক্সি পরীক্ষা করার জন্য এগিয়ে যেতে পারেন।
ক্লাসিক Edge (প্রাইভেট ক্লাউড)
ক্লাসিক Edge UI ব্যবহার করে SOAP পরিষেবা প্রক্সি করতে:
http://ms-ip:9000-এ সাইন-ইন করুন, যেখানে ms-ip হল ম্যানেজমেন্ট সার্ভার নোডের IP অ্যাড্রেস বা DNS নাম।- উপরের নেভিগেশন বারে API > API প্রক্সি বিকল্প বেছে নিন।
- + API প্রক্সি বিকল্পে ক্লিক করুন।
- SOAP পরিষেবা বিকল্পে ক্লিক করুন।
- প্রক্সি বিবরণ পৃষ্ঠায়, নিম্নলিখিত তথ্য লিখুন:
ফিল্ড বিবরণ WSDL বেছে নিন: URL-এর উদাহরণ
তারপর এটি বেছে নিন:
...delayedstockquote.asmx?WSDLএখানে ক্লিক করুন: যাচাই করুন
Apigee Edge WSDL ফাইলটি পায় এবং SOAP পরিষেবা যেসব অপারেশন সাপোর্ট করে তার তালিকা খুঁজে পেতে এটি পড়ে।
প্রক্সির নাম এন্টার করুন:
delayedstockquoteএটি হল আপনার তৈরি করা প্রক্সির নাম।
প্রক্সি বেস পাথ ও বিবরণ যেমন আছে তেমন রেখে দিন। - পরবর্তী বিকল্পে ক্লিক করুন।
- WSDL পৃষ্ঠায়, এইসব বিকল্প বেছে নিন:
এই ফিল্ডে এটি করুন API প্রক্সি টাইপ বেছে নিন: REST থেকে SOAP থেকে REST
প্রক্সি ধরন বেছে নেওয়ার পরে, Edge সেইসব অপারেশনের তালিকা দেখায় যেগুলির জন্য এটি REST API পাথ তৈরি করবে, যেমন এখানে দেখানো হয়েছে। এই তালিকা আপনাকে WSDL-এ পাওয়া অপারেশনগুলির মধ্যে থেকে বেছে নেওয়ার সুযোগ দেয় (যদি আপনার কাছে নির্দিষ্ট সেট থাকে যা আপনি খুঁজছেন)। এছাড়াও, লক্ষ্য করুন যে সারণীতে এমন রিসোর্স দেখানো হয়েছে যা ব্যাকএন্ড SOAP পরিষেবায় কল করার জন্য REST ক্লায়েন্ট ব্যবহার করতে পারে।
আপাতত, অপারেশনগুলির প্রথম সেটটি বেছে নেওয়া অবস্থায় রেখে দিন।
পোর্ট টাইপ: DelayedStockQuoteSoap তিনটি WSDL অপারেশনই বেছে নিন। অন্যান্য সেটিংস যেমন আছে তেমনই রাখুন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- নিরাপত্তা পৃষ্ঠায়, পাস থ্রু (কোনওটি নয়) বিকল্প বেছে নিন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- ভার্চুয়াল হোস্টের ডিফল্ট মান গ্রহণ করুন এবং পরবর্তী বিকল্পে ক্লিক করুন।
- বিল্ড পৃষ্ঠায়, ডিফল্ট মান গ্রহণ করুন এবং Edge-কে প্রক্সি তৈরি করতে দিতে, বিল্ড ও ডেপ্লয় করুন বিকল্পে ক্লিক করুন।
Edge একটি RESTful API প্রক্সি তৈরি করে। WSDL থেকে, এটি পরিষেবার সাপোর্ট করা অপারেশন, ইনপুট প্যারামিটার ইত্যাদি নির্ধারণ করে। প্রতিটি অপারেশনের জন্য কোন HTTP পদ্ধতি ব্যবহার করতে হবে তা Edge সাজেস্ট করে। সাধারণত, Edge অপারেশনকে GET অনুরোধে ট্রান্সলেট করে, যার ক্যাশে করা যায়। এছাড়াও, Edge ব্যাকএন্ড টার্গেট এন্ডপয়েন্ট সেট-আপ করে, যা প্রতিটি SOAP অপারেশনের জন্য আলাদা হতে পারে।
আপনি নতুন প্রক্সি কাস্টমাইজ না করলে (এই টিউটোরিয়ালে আপনাকে তা করতে হবে না), এই প্রক্রিয়াটি এখানেই শেষ হয়ে যায়। আপনি নতুন প্রক্সি পরীক্ষা করে দেখতে পারেন।
প্রক্সি পরীক্ষা করা
আপনার তৈরি করা প্রক্সি ব্যবহার করে দেখতে, কমান্ড প্রম্পট খুলুন এবং cURL ব্যবহার করুন। নিচে দেওয়া কমান্ডটি টাইপ করুন যেখানে:
- ORG হল Edge সংস্থার নাম যেখানে আপনি প্রক্সি তৈরি করেছেন।
- ENV হল সেই এনভায়রনমেন্ট যেখানে প্রক্সি ডেপ্লয় করা হয়।
- আপনি যে Edge ইনস্ট্যান্স ব্যবহার করছেন, DOMAIN তার সাথে সম্পর্কিত।
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.-এর ক্লাস 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 থেকে SOAP থেকে REST" ব্যবহার করে কোনও SOAP পরিষেবার প্রক্সি করলে, Edge অটোমেটিক OpenAPI স্পেসিফিকেশন জেনারেট করে। আপনি API-এর জন্য API ডকুমেন্টেশন তৈরি করতে OpenAPI স্পেসিফিকেশন ব্যবহার করতে পারবেন।
OpenAPI Spec পেতে, এই URL-এ যান:
curl https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/openapi.jsonঅতিরিক্ত ক্রেডিট: কোন রিসোর্স, ভার্ব ও কোয়েরি প্যারামিটার ব্যবহার করতে হবে তা আপনি কীভাবে বুঝবেন?
টেস্ট API কলে, আপনি ব্যাকএন্ড SOAP পরিষেবায় cURL কলে একটি নির্দিষ্ট রিসোর্স ও কোয়েরি প্যারামিটার ব্যবহার করেছেন । কিন্তু আপনি কীভাবে নিজে থেকে তা খুঁজে পাবেন?
রিসোর্স ও ক্রিয়া
আপনি যখন API প্রক্সি উইজার্ডে প্রক্সি তৈরি করছিলেন, তখন SOAP অপারেশনগুলি কীভাবে API ভার্ব ও রিসোর্সে ম্যাপ করা হবে তা দেখেছেন। কিন্তু আপনি যদি সেগুলি লিখে না রাখেন, তাহলে প্রক্সি তৈরি হওয়ার পরে কীভাবে সেগুলি খুঁজে পাবেন তা এখানে দেওয়া হল।
API প্রক্সির ডেভেলপ করুন ট্যাবে, বাঁদিকের নেভিগেটর প্যানেলে আপনি প্রক্সি এন্ডপয়েন্টের অধীনে
ফ্লোয়ের একটি তালিকা দেখতে পাবেন। আপনি যে ফ্লোতে আগ্রহী সেটিতে ক্লিক করুন। যেমন,
GetQuote ফ্লো একটি ভাল বিকল্প। তারপর, কোড প্যানেলে XML দেখুন,
যা <Condition> এলিমেন্টে ফ্লোয়ের রিসোর্স পাথ ও ভার্ব দেখায়:
/quote ও GET.
কোয়েরি প্যারামিটার
GetQuote ফ্লো বেছে নেওয়া হলে, গ্রাফিক্যাল
ফ্লো ভিউতে প্রথম নীতিতে ক্লিক করুন। এটি একটি এক্সট্র্যাক্ট ভেরিয়েবল নীতি হতে হবে যা কোয়েরি প্যারামিটার ক্যাপচার করে যা
পাস করা হবে বলে আশা করা হয়: StockSymbol এবং LicenseKey। (আপনি SOAP পরিষেবার জন্য ওয়েব
সার্চ করলে, LicenseKey-এর জন্য কী পাস করতে হবে তা আপনাকে বলা হবে।)
ক্যাপচার করা কোয়েরি প্যারামিটারগুলি ভেরিয়েবল হিসেবে সেভ করা হয় এবং SOAP মেসেজ তৈরি করতে পরবর্তী নীতি ব্যবহার করে।