আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য
এই বিষয়ে SOAP-ভিত্তিক ওয়েব পরিষেবার জন্য কীভাবে API প্রক্সি তৈরি করতে হয় তা ব্যাখ্যা করা হয়েছে। Edge-এ আপনি দুই ধরনের SOAP প্রক্সি তৈরি করতে পারবেন। একটি ব্যাকএন্ডে RESTful ইন্টারফেস তৈরি করে SOAP পরিষেবা এবং অন্যটি ব্যাকএন্ডে SOAP মেসেজের "পাস থ্রু" পারফর্ম করে। এই বিষয়ে দুটি টেকনিকের বর্ণনা দেওয়া আছে।
এই ভিডিওতে API প্রক্সি উইজার্ড ব্যবহার করে Apigee Edge-এর মাধ্যমে SOAP পরিষেবাকে REST পরিষেবায় পরিবর্তন করার সম্পূর্ণ ডেমো দেখানো হয়েছে। তবে, আপনি যদি SOAP-থেকে-REST ট্রান্সফর্মেশনের উপর আরও বেশি নিয়ন্ত্রণ চান, তাহলে নীতি ব্যবহার করে একটি প্রক্সি তৈরি করতে পারেন। আরও তথ্যের জন্য, টিউটোরিয়াল: Apigee Edge-এ SOAP-to-REST API প্রক্সি ম্যানুয়ালি তৈরি করা দেখুন।
SOAP-ভিত্তিক পরিষেবার জন্য RESTful API প্রক্সি তৈরি করা
বিল্ড এ প্রক্সি উইজার্ডে REST থেকে SOAP থেকে REST বিকল্পের সাহায্যে কীভাবে RESTful SOAP API প্রক্সি তৈরি করতে হয় তা এই বিভাগে ব্যাখ্যা করা হয়েছে।
এক নজরে
REST থেকে SOAP থেকে REST বিকল্পটি WSDL প্রসেস করে RESTful API প্রক্সি তৈরি করে। Edge, WSDL থেকে পরিষেবার কাজ করার উপযুক্ত অপারেশন, ইনপুট প্যারামিটার, ইত্যাদি নির্ধারণ করে। প্রতিটি অপারেশনের জন্য কোন HTTP পদ্ধতি ব্যবহার করতে হবে তা Edge "অনুমান" করে। সাধারণত, Edge, অপারেশনকে GET অনুরোধে ট্রান্সলেট করে, যার ফলে সেগুলি ক্যাশে করা যায়। এছাড়াও, Edge ব্যাকএন্ড টার্গেট এন্ডপয়েন্ট সেট-আপ করে, যা SOAP অপারেশন অনুযায়ী আলাদা হতে পারে।
এই ধরনের প্রক্সির জন্য, Edge অটোমেটিক একটি OpenAPI স্পেসিফিকেশন তৈরি করে, যা আপনি API ডকুমেন্টেশন তৈরি করতে ব্যবহার করতে পারেন।
প্রাথমিক ধাপ
Edge
Edge UI ব্যবহার করে SOAP-ভিত্তিক পরিষেবার জন্য RESTful API প্রক্সি তৈরি করতে:
- apigee.com/edge লিঙ্কে গিয়ে সাইন-ইন করুন।
- বাঁদিকের নেভিগেশন বারে ডেভেলপ করুন > API প্রক্সি বিকল্প বেছে নিন।
- +প্রক্সি বিকল্পে ক্লিক করুন।
- SOAP পরিষেবা বিকল্পে ক্লিক করুন।
- প্রক্সি বিবরণ পৃষ্ঠায়, WSDL ফাইল দিন।
ফিল্ড বিবরণ WSDL ফাইল দিন WSDL-এর সোর্স বেছে নিন।
- ওয়েব অ্যাড্রেস (URL) থেকে - WSDL-এর URL লিখুন বা পেস্ট করুন।
- আমার কম্পিউটার থেকে - আপনার লোকাল ডিরেক্টরি থেকে WSDL ফাইল আপলোড করুন। নির্ভরতা থাকলে আপনি একাধিক ফাইল আপলোড করতে পারবেন।
- WSDL যাচাই করতে যাচাই করুন বিকল্পে ক্লিক করুন।
- নিম্নলিখিত প্রক্সি বিবরণ লিখুন:
ফিল্ড বিবরণ নাম আপনার API-এর জন্য দেখানো নাম। বর্ণসাংখ্যিক অক্ষর, ড্যাশ (-) বা আন্ডারস্কোর (_) উল্লেখ করুন। বেস পাথ আপনার API প্রক্সির http(s)://[host] অ্যাড্রেসের পরে দেখানো URI ফ্র্যাগমেন্ট। Edge, ইনকামিং অনুরোধ মেসেজ ম্যাচ ও রুট করার জন্য বেস পাথ URI ব্যবহার করে সঠিক API প্রক্সি।
NOTE: API প্রক্সি বেস পাথ ডিফল্ট হিসেবে
Nameফিল্ডের জন্য নির্দিষ্ট করা ভ্যালু নেয়, যা সব লোয়ার কেসে কনভার্ট করা হয়।বেস পাথ অনুসরণ করে যেকোনও অতিরিক্ত রিসোর্স URL থাকে। এখানে সম্পূর্ণ URL স্ট্রাকচার দেওয়া হল যা ক্লায়েন্ট আপনার API প্রক্সি কল করার জন্য ব্যবহার করবে:
https://[host]/base_path/conditional_flow_pathNOTE: বেস পাথ অনন্য হতে হবে; আপনি একই বেস পাথ সহ দুটি API প্রক্সি ডেপ্লয় করতে পারবেন না। আপনি কোনও ডিপ্লয় করা API প্রক্সি এডিট করে অন্য API প্রক্সির বেস পাথের সমান ভ্যালুতে বেস পাথ সেট করলে, আপনি সেটি সেভ করার সময় Edge অটোমেটিক API প্রক্সি আনডিপ্লয় করে দেয়। API প্রক্সি আবার ডেপ্লয় করার আগে, আপনাকে বেস পাথ এডিট করে অনন্য করতে হবে।
বেস পাথে ওয়াইল্ডকার্ড ব্যবহার করা
আপনার API প্রক্সি যাতে ভবিষ্যতে কাজ করে সেই জন্য API প্রক্সি বেস পাথে এক বা একাধিক
/*/ওয়াইল্ডকার্ড ব্যবহার করুন। যেমন,/team/*/membersবেস পাথ ক্লায়েন্টকেhttps://[host]/team/blue/membersওhttps://[host]/team/green/membersকল করতে দেয়, এর জন্য আপনাকে নতুন টিমকে সহায়তা করার জন্য নতুন API প্রক্সি তৈরি করতে হয় না। মনে রাখবেন,/**/কাজ করে না।বিবরণ (ঐচ্ছিক) API-এর বিবরণ। - পরবর্তী বিকল্পে ক্লিক করুন।
- উইজার্ডের সাধারণ নীতি পৃষ্ঠায়, নিম্নলিখিতগুলি কনফিগার করুন:
- নিরাপত্তা: অনুমোদন বিকল্পের অধীনে নিরাপত্তা সংক্রান্ত অনুমোদনের প্রয়োজনীয়তা। নিরাপত্তা যোগ করা দেখুন।
- নিরাপত্তা: ব্রাউজার বিকল্পের অধীনে ক্রস-অরিজিন রিসোর্স শেয়ারিং (CORS)-এর জন্য সহায়তা। CORS-এর জন্য সহায়তা যোগ করা দেখুন।
- Quotaর অধীনে বেশি ট্রাফিক থেকে আপনার ব্যাকএন্ড পরিষেবা সুরক্ষিত রাখতে কোটা। কোটা দেখুন। (পাস-থ্রু অনুমোদন বেছে নেওয়া হলে উপলভ্য থাকে না।)
- WSDL অপারেশন পৃষ্ঠায়, API প্রক্সি ধরন REST থেকে SOAP থেকে
REST বেছে নিন।
WSDL ফাইলে Edge "ডিসকভার" করেছে এমন অপারেশনগুলির একটি তালিকা সহ টেবিল দেখানো হয়। আপনার API প্রক্সিতে কোন কোন অপারেশন যোগ করতে চান তা বেছে নিতে ও কনফিগার করতে পারবেন। নিচের ছবিতে টেবিলটি দেখানো হয়েছে।
- আপনি কোন সেট অপারেশন ব্যবহার করতে চান তা নির্দিষ্ট করতে ড্রপ-ডাউন থেকে একটি পোর্ট টাইপ বেছে নিন। WSDL-এ, পোর্ট টাইপ এলিমেন্ট সেইসব অপারেশনকে সংজ্ঞায়িত করে যা আপনি ওয়েব পরিষেবায় কল করতে পারেন।
- কোনও অপারেশনের জন্য REST API পাথ ঐচ্ছিকভাবে পরিবর্তন করুন। API প্রক্সি URL-এ পাথটি রিসোর্স নাম হিসেবে ব্যবহার করা হবে।
- ঐচ্ছিকভাবে অপারেশনের সাথে যুক্ত ক্রিয়া (HTTP পদ্ধতি) পরিবর্তন করুন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- উইজার্ডের ভার্চুয়াল হোস্ট পৃষ্ঠায়, API প্রক্সি ডেপ্লয় করার সময় যে ভার্চুয়াল হোস্টের সাথে বাইন্ড করবে সেটি বেছে নিন। আরও তথ্যের জন্য, ভার্চুয়াল হোস্ট সম্পর্কে দেখুন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- ডেপ্লয়মেন্ট এনভায়রনমেন্ট বেছে নিন এবং তৈরি ও ডেপ্লয় করুন
বিকল্পে ক্লিক করুন আপনার নতুন API প্রক্সি তৈরি করা হয়েছে এবং বেছে নেওয়া এনভায়রনমেন্টে ডেপ্লয় করা হয়েছে। - API প্রক্সি সংক্রান্ত বিবরণ পৃষ্ঠা দেখতে প্রক্সি এডিট করুন বিকল্পে ক্লিক করুন।
ক্লাসিক Edge (প্রাইভেট ক্লাউড)
ক্লাসিক Edge UI ব্যবহার করে SOAP-ভিত্তিক পরিষেবার জন্য RESTful API প্রক্সি তৈরি করতে:
http://ms-ip:9000-এ সাইন-ইন করুন, যেখানে ms-ip হল ম্যানেজমেন্ট সার্ভার নোডের IP অ্যাড্রেস বা DNS নাম।- উপরের নেভিগেশন বারে API > API প্রক্সি বিকল্প বেছে নিন।
- + API প্রক্সি বিকল্পে ক্লিক করুন।
- 'প্রক্সি তৈরি করুন' উইজার্ডে, SOAP পরিষেবা বেছে নিন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- বিবরণ পৃষ্ঠায়, এইসব বিকল্প বেছে নিন। WSDL বেছে নেওয়ার পরে আপনাকে অবশ্যই যাচাই করুন বিকল্পে ক্লিক করতে হবে।
এই ফিল্ডে এটি করুন WSDL WSDL-এর সোর্স বেছে নিন।
- URL - আপনি যে WSDL ব্যবহার করতে চান সেটির URL লিখুন।
- ফাইল - আপনার ফাইল সিস্টেমে একটি WSDL ফাইল বেছে নিন। যেসব ক্ষেত্রে অতিরিক্ত নির্ভরশীল ফাইল থাকে, আপনি সেগুলির সবকটি বেছে নিতে পারবেন।
- URL-এর উদাহরণ - সর্বজনীনভাবে উপলভ্য ওয়েব পরিষেবার জন্য WSDL-এর তালিকা থেকে বেছে নিন। Edge-এর SOAP/API প্রক্সি ফিচার পরীক্ষা করে দেখার জন্য এগুলি খুব উপযোগী।
প্রক্সির নাম এটি হল আপনার তৈরি করা প্রক্সির নাম।
প্রক্সি বেস পাথ আপনার API প্রক্সির http(s)://[host] অ্যাড্রেসের পরে দেখানো URI ফ্র্যাগমেন্ট। Edge, ইনকামিং অনুরোধ মেসেজ ম্যাচ ও রুট করার জন্য বেস পাথ URI ব্যবহার করে সঠিক API প্রক্সি।
মনে রাখবেন: API প্রক্সি বেস পাথ ডিফল্ট হিসেবে
Nameফিল্ডের জন্য নির্দিষ্ট করা ভ্যালু নেয়, যা সব লোয়ার কেসে কনভার্ট করা হয়।বেস পাথ অনুসরণ করে যেকোনও অতিরিক্ত রিসোর্স URL থাকে। এখানে সম্পূর্ণ URL স্ট্রাকচার দেওয়া হল যা ক্লায়েন্ট আপনার API প্রক্সি কল করার জন্য ব্যবহার করবে:
https://[host]/base_path/conditional_flow_pathমনে রাখবেন: বেস পাথ অনন্য হতে হবে; আপনি একই বেস পাথ সহ দুটি API প্রক্সি ডেপ্লয় করতে পারবেন না। আপনি কোনও ডিপ্লয় করা API প্রক্সি এডিট করে অন্য API প্রক্সির বেস পাথের সমান ভ্যালুতে বেস পাথ সেট করলে, আপনি সেটি সেভ করার সময় Edge অটোমেটিক API প্রক্সি আনডিপ্লয় করে দেয়। API প্রক্সি আবার ডেপ্লয় করার আগে, আপনাকে বেস পাথ এডিট করে অনন্য করতে হবে।
বেস পাথে ওয়াইল্ডকার্ড ব্যবহার করা
আপনার API প্রক্সি যাতে ভবিষ্যতে কাজ করে সেই জন্য API প্রক্সি বেস পাথে এক বা একাধিক
/*/ওয়াইল্ডকার্ড ব্যবহার করুন। যেমন,/team/*/membersবেস পাথ ক্লায়েন্টকেhttps://[host]/team/blue/membersওhttps://[host]/team/green/membersকল করতে দেয়, এর জন্য আপনাকে নতুন টিমকে সহায়তা করার জন্য নতুন API প্রক্সি তৈরি করতে হয় না। মনে রাখবেন,/**/কাজ করে না।বিবরণ প্রক্সি সম্পর্কে সংক্ষিপ্ত বিবরণ। - পরবর্তী বিকল্পে ক্লিক করুন।
- WSDL পৃষ্ঠায়, API প্রক্সি ধরন REST থেকে SOAP থেকে
REST বেছে নিন।
WSDL ফাইলে Edge "ডিসকভার" করেছে এমন অপারেশনগুলির একটি তালিকা সহ টেবিল দেখানো হয়। আপনার API প্রক্সিতে কোন কোন অপারেশন যোগ করতে চান তা বেছে নিয়ে কনফিগার করতে পারবেন। নিচের ছবিতে টেবিলটি দেখানো হয়েছে।
- আপনি কোন অপারেশন সেট ব্যবহার করতে চান তা পোর্ট টাইপ কলাম থেকে বেছে নিন। WSDL-এ, পোর্ট টাইপ এলিমেন্ট সেইসব অপারেশনকে সংজ্ঞায়িত করে যা আপনি ওয়েব পরিষেবায় কল করতে পারেন।
- অপারেশনের সাথে যুক্ত HTTP পদ্ধতি চাইলে পরিবর্তন করুন।
মনে রাখবেন: Edge প্রতিটি অপারেশনের জন্য ব্যবহার করার HTTP পদ্ধতি নির্ধারণ করার ক্ষেত্রে "সেরা অনুমান" করে। সাধারণত GET পদ্ধতি পছন্দ করা হয় কারণ GET অনুরোধ ক্যাশে করা যায়।
- বিকল্প হিসেবে, কোনও অপারেশনের জন্য REST API পাথ পরিবর্তন করুন। API প্রক্সি URL-এ পাথটি রিসোর্স নাম হিসেবে ব্যবহার করা হবে।
- নিরাপত্তা যোগ করতে, ভার্চুয়াল হোস্ট বেছে নিতে এবং ডিপ্লয়মেন্ট এনভায়র্নমেন্টের জন্য উইজার্ডের বাকি অংশ ক্লিক করে দেখুন।
- বিল্ড পৃষ্ঠায়, বিল্ড ও ডেপ্লয় করুন বিকল্পে ক্লিক করুন। Edge, WSDL-এর উপর ভিত্তি করে নতুন API প্রক্সি জেনারেট ও ডেপ্লয় করে।
- নতুন API প্রক্সির সারসংক্ষেপ পৃষ্ঠায় যান। মনে রাখবেন, WSDL ফাইলে পাওয়া অপারেশনগুলির উপর ভিত্তি করে রিসোর্সের একটি সেট
তৈরি করা হয়েছে।
প্রক্সির ওভারভিউ পৃষ্ঠায়, রিসোর্স তালিকা নতুন API, এর অপারেশন ও প্যারামিটার সম্পর্কে বিস্তারিত বিবরণ প্রদান করে। আপনি এই প্রতিনিধিত্বকে API-এর রেফারেন্স ডকুমেন্টেশন হিসেবে বিবেচনা করতে পারেন। Edge আপনার জন্য API মডেলের এই ভিউ অটোমেটিক জেনারেট করে। কোনও রিসোর্সের বিবরণ ও পাথ সম্পর্কিত তথ্য দেখতে সেটি বড় করুন।
চূড়ান্ত প্রক্সি সম্পর্কে
Edge যখন WSDL-এর উপর ভিত্তি করে কোনও API প্রক্সি তৈরি করে, তখন ফলাফল হিসেবে প্রাপ্ত প্রক্সিটি আসলে একটি জটিল ফ্লো হয় যার মধ্যে ডেটা ট্রান্সফর্ম করা, ভেরিয়েবল এক্সট্র্যাক্ট ও সেট করা, মেসেজ ম্যানিপুলেট করা এবং আরও অনেক কিছু সংক্রান্ত নীতি অন্তর্ভুক্ত থাকে। WSDL-এর উপর ভিত্তি করে প্রক্সি তৈরি করার পরে, API ম্যানেজমেন্ট UI-এর ডেভেলপ ভিউতে ফ্লোয়ের ফলাফল দেখুন। সেখানে, ঠিক কোন কোন নীতি যোগ করা হয়েছে তা আপনি দেখতে পাবেন।
যেমন, অনুরোধের ক্ষেত্রে, টার্গেট URL সেট করার জন্য AssignMessage নীতি ব্যবহার করা হয়। রেসপন্স সাইডে, XML থেকে JSON-এ রেসপন্স ট্রান্সফর্ম করতে, রেসপন্সের SOAP বডি পার্টকে ভেরিয়েবলে এক্সট্র্যাক্ট করতে এবং রেসপন্স মেসেজ সেট করতে নীতি এক্সিকিউট করা হয়। আপনি প্রক্সি তৈরি করলে এইসব নীতি (এবং অন্যান্য) অটোমেটিক যোগ হয়ে যায়।
OpenAPI স্পেক: এই প্রক্সির জন্য অটোমেটিক জেনারেট হওয়া OpenAPI স্পেক দেখতে,
http(s)://[proxy_domain]/[proxy_base_path]/openapi.json লিঙ্কে যান। তবে,
কনভার্সন সবসময় সঠিক হয় না, কারণ XML স্কিমার সব নিয়মকে
OpenAPI স্পেসিফিকেশনে দেখানো যায় না।
SOAP-ভিত্তিক পরিষেবার জন্য পাস-থ্রু প্রক্সি তৈরি করা
'নতুন প্রক্সি তৈরি করুন' ডায়ালগে পাস-থ্রু প্রক্সি বিকল্পের মাধ্যমে কীভাবে পাস-থ্রু প্রক্সি তৈরি করতে হয় তা এই বিভাগে ব্যাখ্যা করা হয়েছে।
এক নজরে
পাস-থ্রু প্রক্সি বিকল্প আপনাকে এমন একটি প্রক্সি তৈরি করতে দেয় যা ব্যাকএন্ড পরিষেবাতে একটি অনুরোধে SOAP মেসেজ "অপরিবর্তিত" পাস করে, এটি SOAP-ভিত্তিক ওয়েব পরিষেবার জন্য একটি প্রক্সি তৈরি করা খুব সহজ করে তোলে। Edge আপনার জন্য অটোমেটিক যেকোনও ট্রান্সফর্মেশন ও অন্যান্য ফ্লো অ্যাক্টিভিটি ম্যানেজ করে। যেমন, অনুরোধটি JSON ফর্ম্যাটে হলে, Edge সেটি পরিষেবায় POST করার আগে সঠিক নেমস্পেস সহ বৈধ XML SOAP মেসেজে কনভার্ট করার জন্য পদক্ষেপ নেয়। একইভাবে, পরিষেবা XML-ভিত্তিক SOAP উত্তর দিলে, Edge সেটি ক্লায়েন্টকে ফেরত দেওয়ার আগে JSON-এ অনুবাদ করে। এছাড়াও, Edge ব্যাকএন্ড টার্গেট এন্ডপয়েন্ট সেট-আপ করে, যা SOAP অপারেশন পিছু আলাদা হতে পারে।
এই ধরনের প্রক্সির জন্য, Edge WSDL হোস্ট করে এবং আপনাকে এটি অ্যাক্সেস করতে দেওয়ার জন্য প্রক্সিতে একটি ফ্লো তৈরি করে।
এই Edge-হোস্ট করা WSDL-এর ঠিকানা,
http(s)://[proxy_domain]/[proxy_base_path]?wsdl, নতুন পরিষেবা এন্ডপয়েন্ট
URL হয়ে যায়, যা প্রক্সির মাধ্যমে SOAP পরিষেবায় কল করা ক্লায়েন্টদের জন্য।
প্রাথমিক ধাপ
Edge
Edge UI ব্যবহার করে SOAP-ভিত্তিক পরিষেবার জন্য পাস-থ্রু প্রক্সি তৈরি করতে:
- apigee.com/edge লিঙ্কে গিয়ে সাইন-ইন করুন।
- বাঁদিকের নেভিগেশন বারে ডেভেলপ করুন > API প্রক্সি বিকল্প বেছে নিন।
- +প্রক্সি বিকল্পে ক্লিক করুন।
- SOAP পরিষেবা বিকল্পে ক্লিক করুন।
- প্রক্সি বিবরণ পৃষ্ঠায়, WSDL বিবরণ দিন।
ফিল্ড বিবরণ WSDL WSDL-এর সোর্স বেছে নিন।
- ওয়েব অ্যাড্রেস (URL) থেকে - WSDL-এর URL লিখুন বা পেস্ট করুন।
- আমার কম্পিউটার থেকে - আপনার লোকাল ডিরেক্টরি থেকে WSDL ফাইল আপলোড করুন। নির্ভরতা থাকলে আপনি একাধিক ফাইল আপলোড করতে পারবেন।
নাম API প্রক্সির নাম।
বেস পাথ আপনার API প্রক্সির http(s)://[host] অ্যাড্রেসের পরে URI ফ্র্যাগমেন্ট। Edge, ইনকামিং অনুরোধ মেসেজ ম্যাচ ও রুট করার জন্য বেস পাথ URI ব্যবহার করে সঠিক API প্রক্সি।
মনে রাখবেন: API ভার্সনিং সংক্রান্ত Apigee-এর সাজেশন পেতে, ওয়েব API ডিজাইন: দ্য মিসিং লিঙ্ক ই-বুকের ভার্সনিং দেখুন।
বেস পাথ পরে কোনও অতিরিক্ত রিসোর্স URL থাকে। এখানে সম্পূর্ণ URL স্ট্রাকচার দেওয়া হল যা ক্লায়েন্ট আপনার API প্রক্সি কল করার জন্য ব্যবহার করবে:
https://[host]/base_path/conditional_flow_pathমনে রাখবেন: বেস পাথ অনন্য হতে হবে। আপনি পরে এই প্রক্সি এডিট করে এর বেস পাথ অন্য API প্রক্সির মতো সেট করলে, এটি সেভ করার সময় এই API প্রক্সি অটোমেটিক আনডিপ্লয় হয়ে যায়। আপনাকে অবশ্যই বেস পাথ এডিট করতে হবে, তবেই আপনি এটি আবার ডেপ্লয় করতে পারবেন।
বেস পাথে ওয়াইল্ডকার্ড ব্যবহার করা
আপনার প্রক্সি যাতে ভবিষ্যতেও কাজ করে সেই জন্য API প্রক্সি বেস পাথে এক বা একাধিক
/*/ওয়াইল্ডকার্ড ব্যবহার করতে পারেন। যেমন,/team/*/membersবেস পাথ ক্লায়েন্টকেhttps://[host]/team/blue/membersওhttps://[host]/team/green/membersকল করার অনুমতি দেয়, এর জন্য আপনাকে নতুন টিমকে সহায়তা করার জন্য নতুন API প্রক্সি তৈরি করতে হয় না। মনে রাখবেন, /**/ কাজ করে না।মনে রাখবেন: API প্রক্সি বেস পাথ ডিফল্ট হিসেবে নাম ফিল্ডের জন্য নির্দিষ্ট করা ভ্যালু নেয়, যা সবকটি ছোট হাতের অক্ষরে কনভার্ট করা হয়। আপনি বেস পাথ ফিল্ডে কন্টেন্ট এডিট না করলে এটি হয়।
বিবরণ (ঐচ্ছিক) API-এর বিবরণ। - পরবর্তী বিকল্পে ক্লিক করুন।
- উইজার্ডের সাধারণ নীতি পৃষ্ঠায়, নিম্নলিখিতগুলি কনফিগার করুন:
- সুরক্ষা সংক্রান্ত অনুমোদনের প্রয়োজনীয়তা। নিরাপত্তা যোগ করা দেখুন।
- ক্রস-অরিজিন রিসোর্স শেয়ারিং (CORS)-এর জন্য সহায়তা। CORS-এর জন্য সহায়তা যোগ করা দেখুন।
- অতিরিক্ত ট্রাফিক থেকে আপনার ব্যাকএন্ড পরিষেবা সুরক্ষিত রাখতে কোটা। কোটা দেখুন। (পাস-থ্রু অনুমোদন বেছে নেওয়া হলে উপলভ্য থাকে না।)
- যেসব সংস্থার জন্য মনিটাইজেশন চালু করা আছে, তাদের ক্ষেত্রে মনিটাইজেশন সংক্রান্ত সীমা প্রয়োগ করা। API প্রক্সিতে মনিটাইজেশন সংক্রান্ত বিধিনিষেধ প্রয়োগ করা দেখুন।
- WSDL পৃষ্ঠায়, API প্রক্সি টাইপ পাস-থ্রু SOAP বেছে নিন।
- আপনি কোন সেট অপারেশন ব্যবহার করতে চান তা নির্দিষ্ট করতে ড্রপ-ডাউন থেকে একটি পোর্ট টাইপ বেছে নিন। WSDL-এ, পোর্ট টাইপ এলিমেন্ট সেইসব অপারেশনকে সংজ্ঞায়িত করে যা আপনি ওয়েব পরিষেবায় কল করতে পারেন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- উইজার্ডের ভার্চুয়াল হোস্ট পৃষ্ঠায়, API প্রক্সি ডেপ্লয় করার সময় যে ভার্চুয়াল হোস্টের সাথে বাইন্ড করবে সেটি বেছে নিন। আরও তথ্যের জন্য, ভার্চুয়াল হোস্ট সম্পর্কে দেখুন।
- ডেপ্লয়মেন্ট এনভায়রনমেন্ট বেছে নিন এবং তৈরি ও ডেপ্লয় করুন
বিকল্পে ক্লিক করুন আপনার নতুন API প্রক্সি তৈরি করা হয়েছে এবং বেছে নেওয়া এনভায়রনমেন্টে ডেপ্লয় করা হয়েছে। - API প্রক্সি সংক্রান্ত বিবরণ পৃষ্ঠা দেখতে প্রক্সি এডিট করুন বিকল্পে ক্লিক করুন।
ক্লাসিক Edge (প্রাইভেট ক্লাউড)
ক্লাসিক Edge UI ব্যবহার করে SOAP-ভিত্তিক পরিষেবার জন্য পাস-থ্রু প্রক্সি তৈরি করতে:
http://ms-ip:9000-এ সাইন-ইন করুন, যেখানে ms-ip হল ম্যানেজমেন্ট সার্ভার নোডের IP অ্যাড্রেস বা DNS নাম।- উপরের নেভিগেশন বারে API > API প্রক্সি বিকল্প বেছে নিন।
- + API প্রক্সি বিকল্পে ক্লিক করুন।
- 'প্রক্সি তৈরি করুন' উইজার্ডে, SOAP পরিষেবা বেছে নিন।
- পরবর্তী বিকল্পে ক্লিক করুন।
- বিবরণ পৃষ্ঠায়, এইসব বিকল্প বেছে নিন। WSDL বেছে নেওয়ার পরে আপনাকে অবশ্যই যাচাই করুন বিকল্পে ক্লিক করতে হবে।
এই ফিল্ডে এটি করুন WSDL WSDL-এর সোর্স বেছে নিন।
- URL - আপনি যে WSDL ব্যবহার করতে চান তার URL লিখুন।
- ফাইল - আপনার ফাইল সিস্টেমে একটি WSDL ফাইল বেছে নিন। যেসব ক্ষেত্রে অতিরিক্ত নির্ভরশীল ফাইল আছে, আপনি সেগুলির সবকটি বেছে নিতে পারবেন।
- URL-এর উদাহরণ - সর্বজনীনভাবে উপলভ্য ওয়েব পরিষেবার জন্য WSDL-এর তালিকা থেকে বেছে নিন। এগুলি Edge-এর SOAP/API প্রক্সি ফিচার ব্যবহার করে দেখার জন্য খুবই উপযোগী।
প্রক্সির নাম এটি হল আপনার তৈরি করা প্রক্সির নাম।
প্রক্সি বেস পাথ প্রক্সি বেস পাথ হল একটি URI ফ্র্যাগমেন্ট যা এই API প্রক্সি দ্বারা এক্সপোজ করা API-কে অনন্যভাবে শনাক্ত করে। API পরিষেবা, সঠিক API প্রক্সিতে ইনকামিং অনুরোধ মেসেজ ম্যাচ ও রাউট করার জন্য Base Path URI ব্যবহার করে। (API-এর ডোমেনে বেস পাথ যোগ করা হয়, যা আপনার সংস্থার নাম ও API প্রক্সি যেখানে ডেপ্লয় করা হয়েছে সেই এনভায়রনমেন্ট অনুযায়ী অটোমেটিক জেনারেট করা হয়।) প্রোজেক্টের নামে ভার্সন নম্বর যোগ করা একটি ভাল প্র্যাক্টিস, যেমন, /v1/delayedstockquote। এটি নির্ধারণ করবে যে কীভাবে কনজিউমার অ্যাপের মাধ্যমে আপনার API আহ্বান করা হবে।মনে রাখবেন: Proxy Base Path-এর ডিফল্ট মান হল Proxy Name-এর জন্য নির্দিষ্ট মান যা Proxy Base Path ফিল্ডে কন্টেন্ট এডিট না করলে সব লোয়ার কেসে কনভার্ট করা হয়।
বিবরণ প্রক্সি সম্পর্কে সংক্ষিপ্ত বিবরণ। - পরবর্তী বিকল্পে ক্লিক করুন।
- WSDL পৃষ্ঠায়, API প্রক্সি ধরন পাস-থ্রু SOAP বেছে নিন।
মনে রাখবেন: প্রতিটি WSDL অপারেশন ও তার সংশ্লিষ্ট SOAP পেলোড তালিকাভুক্ত করে একটি টেবিল দেখানো হয়। এটি হল সেই পে-লোড যা ব্যাকএন্ড SOAP পরিষেবায় "পাস করা" হয়।
- আপনি কোন অপারেশন সেট ব্যবহার করতে চান তা পোর্ট টাইপ কলাম থেকে বেছে নিন। WSDL-এ, পোর্ট টাইপ এলিমেন্ট সেইসব অপারেশনকে সংজ্ঞায়িত করে যা আপনি ওয়েব পরিষেবায় কল করতে পারেন।
- নিরাপত্তা যোগ করতে, ভার্চুয়াল হোস্ট বেছে নিতে এবং ডিপ্লয়মেন্ট এনভায়র্নমেন্টের জন্য উইজার্ডের বাকি অংশ ক্লিক করে দেখুন।
- বিল্ড পৃষ্ঠায়, বিল্ড ও ডেপ্লয় করুন বিকল্পে ক্লিক করুন। Edge, WSDL-এর উপর ভিত্তি করে নতুন API প্রক্সি জেনারেট ও ডেপ্লয় করে।
চূড়ান্ত প্রক্সি সম্পর্কে
Edge যখন পাস-থ্রু প্রক্সি তৈরি করে, তখন ফলাফল হিসেবে যে প্রক্সি পাওয়া যায় সেটি আসলে একটি জটিল ফ্লো যা ডেটা ট্রান্সফর্ম করা, ভেরিয়েবল এক্সট্র্যাক্ট ও সেট করা, মেসেজ ম্যানিপুলেট করা এবং আরও অনেক কিছু সংক্রান্ত নীতি অন্তর্ভুক্ত করে। পাস-থ্রু প্রক্সি জেনারেট করার পরে, API ম্যানেজমেন্ট UI-এর ডেভেলপ ভিউতে ফলাফল কেমন হল তা দেখুন। সেখানে, ঠিক কোন কোন নীতি যোগ করা হয়েছে তা আপনি দেখতে পাবেন।
যেমন, নিচের ছবিতে পাস-থ্রু প্রক্সির টার্গেট এন্ডপয়েন্ট প্রিফ্লো অংশ দেখানো হয়েছে। অনুরোধের দিকে, টার্গেট URL সেট করার জন্য AssignMessage নীতি ব্যবহার করা হয়। রেসপন্স সাইডে, XML থেকে JSON-এ রেসপন্স ট্রান্সফর্ম করতে, রেসপন্সের SOAP বডি পার্টটি একটি ভেরিয়েবলে এক্সট্র্যাক্ট করতে এবং রেসপন্স মেসেজ সেট করতে নীতি এক্সিকিউট করা হয়। আপনি প্রক্সি তৈরি করলে এইসব নীতি (এবং অন্যান্য) অটোমেটিক যোগ হয়ে যায়।
এজ-হোস্টেড WSDL: এই ধরনের প্রক্সির জন্য জেনারেট করা এজ-হোস্টেড WSDL দেখতে
http(s)://[proxy_domain]/[proxy_base_path]?wsdl-এ যান।
উন্নত SOAP-থেকে-REST প্রক্সি ডেভেলপমেন্ট
Edge-এ API প্রক্সি উইজার্ড ব্যবহার করে SOAP-থেকে-REST API প্রক্সি তৈরি করার বিষয়টি আগের বিভাগে আলোচনা করা হয়েছে। তবে, আপনি যদি SOAP-থেকে-REST ট্রান্সফর্মেশনের উপর আরও সূক্ষ্ম-গ্রেন কন্ট্রোল চান, তাহলে উইজার্ডের দেওয়া অটোমেশন বাইপাস করতে পারেন এবং আপনি যে আচরণ চান তা পেতে ম্যানুয়ালি নীতি যোগ ও কনফিগার করে একটি প্রক্সি তৈরি করতে পারেন। আরও তথ্যের জন্য, এগুলি দেখুন: টিউটোরিয়াল: Apigee Edge-এ SOAP-to-REST API প্রক্সি ম্যানুয়ালি তৈরি করা।