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