ইন্টিগ্রেশন ডিরেক্টরি
Amadeus API ইন্টিগ্রেশন: ফ্লাইট কানেক্টর, ধাপে ধাপে সেটআপ
Amadeus মডিউল আপনার PHPTRAVELS ফ্লাইট সার্চকে Amadeus Enterprise-এর সাথে যুক্ত করে। একটি অ্যাপ রেজিস্টার করুন, admin-এ তিনটি ক্রেডেনশিয়াল দিন, ডেভেলপমেন্ট মোডে পরীক্ষা করুন এবং Amadeus অ্যাকাউন্ট অনুমোদন করলে production-এ যান।
- Enterprise প্ল্যানের কানেক্টর
- OAuth2 client credentials
- ডেভেলপমেন্ট ও production
- প্রকাশিত সেটআপ গাইড
কানেক্টর সেটআপ
Amadeus অ্যাপ থেকে লাইভ ফ্লাইট ফলাফল, পাঁচ ধাপে
কানেক্টরটি একটি তৈরি মডিউল, তাই সাধারণ সেটআপে কোনো কোড লিখতে হয় না। আপনি নিজের Amadeus অ্যাকাউন্ট ও বাণিজ্যিক শর্ত আনবেন, আর মডিউলটি PHPTRAVELS ফ্লাইট মডিউলের ভেতরে অথেনটিকেশন, ফ্লাইট সার্চ ও অর্ডার তৈরি সামলায়।
- Enterprise প্ল্যান দিয়ে শুরু করুন, এতে Amadeus মডিউল আছে
- Amadeus for Developers-এ রেজিস্টার করে Flight Offers Search ও Flight Create Orders সহ একটি অ্যাপ তৈরি করুন
- admin-এর Modules-এ grant type, client ID ও client secret দিন, Dev mode চালু রাখুন
- আপনার সাইটে ফ্লাইট খুঁজুন এবং Book now বোতামের নিচে Amadeus লোগো দেখুন
- production কী-র জন্য আবেদন করুন, sandbox কী বদলান এবং Dev mode production-এ দিন
- Dev mode
- ডেভেলপমেন্ট
- এন্ডপয়েন্ট
- travel.api.amadeus.com/v2/
- c1 · grant_type
- client_credentials
- c2 · client_id
- ••••••••••7Kq2
- c3 · client_secret
- ••••••••••
কানেক্টর কী করে
সার্চে Amadeus অফার, admin-এ অর্ডার
দুটি Amadeus API মডিউলটি চালায়: একটি আপনার ফলাফল পেজে ফ্লাইট অফার আনে, অন্যটি যাত্রী পেমেন্ট করলে বুকিং তৈরি করে।
- APIলন্ডন থেকে নিউ ইয়র্ক · ননস্টপইকোনমি · 8 ঘ 05 মি · 1টি চেকড ব্যাগ৪৮৬ US$প্রতি প্রাপ্তবয়স্ক
- v2লন্ডন থেকে নিউ ইয়র্ক · 1 স্টপইকোনমি · 11 ঘ 20 মি, ডাবলিন হয়ে · 1টি চেকড ব্যাগ৪১২ US$প্রতি প্রাপ্তবয়স্ক
- লন্ডন থেকে নিউ ইয়র্ক · ননস্টপবিজনেস · 7 ঘ 55 মি · 2টি চেকড ব্যাগ২,১৪০ US$প্রতি প্রাপ্তবয়স্ক
Flight Offers Search ও Flight Create Orders
Offers Search ফলাফল দেখায়; Create Orders বাছাই করা অফারকে বুকিংয়ে রূপ দেয়। সার্চ ও বুকিংয়ের জন্য আপনার Amadeus অ্যাপে দুটোই চালু করুন।
OAuth2 অথেনটিকেশন
মডিউলটি client_credentials grant দিয়ে অ্যাক্সেস টোকেন চায়, admin-এ দেওয়া client ID ও secret ব্যবহার করে।
ডেভেলপমেন্ট ও production মোড
একটি Dev mode সেটিং ঠিক করে অনুরোধ sandbox কী দিয়ে যাবে নাকি অনুমোদিত production কী দিয়ে।
Enterprise এন্ডপয়েন্ট
মডিউলটি travel.api.amadeus.com/v2/ ভিত্তিক। কিছু অঞ্চলে ভিন্ন এন্ডপয়েন্ট থাকে, তাই কী দেওয়ার আগে আপনারটি নিশ্চিত করুন।
প্রতিটি ফলাফলে উৎস
Book now বোতামের নিচে Amadeus লোগো দেখায় কোন ভাড়া Amadeus থেকে এসেছে, তাই এক নজরে সংযোগ যাচাই করা যায়।
পরিচিত ত্রুটির কারণ
বেশিরভাগ সমস্যা ভুল ক্রেডেনশিয়াল, কী-র সাথে না মেলা মোড, বা Amadeus ড্যাশবোর্ডে নিষ্ক্রিয় API সার্ভিসের কারণে হয়।
অনুরোধের প্রবাহ
প্রতিটি Amadeus সার্চে কী ঘটে
ডেভেলপমেন্ট ও production-এ একই ক্রম চলে; শুধু কী ও Dev mode সেটিং বদলায়।
অথেনটিকেট
আপনার client ID ও secret অ্যাক্সেস টোকেনে বদলানো হয়।
সার্চ
Flight Offers Search রুট, তারিখ ও যাত্রীর জন্য ভাড়া ফেরত দেয়।
প্রদর্শন
অফারগুলো আপনার মার্কআপসহ অন্য সংযুক্ত সাপ্লায়ারের ফলাফলের পাশে দেখা যায়।
অর্ডার
Flight Create Orders যাত্রীর তথ্যসহ বাছাই করা অফার বুক করে।
রেকর্ড
বুকিং admin-এ সংরক্ষিত হয় এবং নিশ্চিতকরণ ইমেল যায়।
Amadeus কোথায় খাপ খায়
আপনার Amadeus অ্যাকাউন্ট, অন্য ফ্লাইট API ও কাস্টম কাজ
Amadeus মডিউল কয়েকটি ফ্লাইট কানেক্টরের একটি, প্রতিটি নিজস্ব ক্রেডেনশিয়ালে একই সার্চে চলে।
আপনার Amadeus Enterprise অ্যাকাউন্ট
Amadeus আপনার ব্যবহারের ধরন, কোম্পানি নিবন্ধন ও ওয়েবসাইট যাচাই করে production কী দেয়, আর আপনি তাদের বাণিজ্যিক শর্ত মেনে নেন।
অন্য ফ্লাইট কানেক্টর
ইন্টিগ্রেশন ডিরেক্টরি থেকে Duffel, Kiwi বা অন্য ফ্লাইট সাপ্লায়ার যোগ করুন এবং এক তালিকায় ভাড়া তুলনা করুন।
অন্য এন্ডপয়েন্ট ও API
আঞ্চলিক Amadeus এন্ডপয়েন্ট বা মডিউল এখনো ব্যবহার করে না এমন API কাস্টম ডেভেলপমেন্ট হিসেবে যোগ করা যায়।
যেসব ফ্লাইট সাপ্লায়ার যুক্ত করা যায়:
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
ব্যাক অফিস
একই admin থেকে Amadeus বুকিং চালান
কী দেওয়ার পর Amadeus ভাড়া সেই নিয়মই মানে যা আপনি অন্য সব ফ্লাইট সাপ্লায়ারের জন্য ব্যবহার করেন।
ফ্লাইট মার্কআপ
নির্দিষ্ট বা শতাংশ মার্কআপ যোগ করুন যাতে Amadeus ভাড়ায় আপনার বিক্রয়মূল্য দেখা যায়।
বুকিং তালিকা
Amadeus বুকিং যাত্রীর তথ্য ও স্ট্যাটাসসহ ফ্লাইট বুকিং স্ক্রিনে থাকে।
B2B এজেন্ট
এজেন্টরা নিজস্ব রেটে এজেন্ট পোর্টালে Amadeus ভাড়া খোঁজে ও বুক করে।
পেমেন্ট
যাত্রীরা আপনার চালু করা গেটওয়েতে পেমেন্ট করেন, বা এজেন্টরা ওয়ালেট থেকে।
আপনার সার্ভারে কী
ক্রেডেনশিয়াল আপনার নিজের সেলফ-হোস্টেড admin-এ সংরক্ষিত থাকে, শেয়ার্ড প্ল্যাটফর্মে নয়।
সাপোর্ট টিকিট
সংযোগ বা বুকিংয়ে সাহায্য লাগলে app.phptravels.com-এ টিকিট খুলুন।
তুলনা
নিজে Amadeus-এ কোডিং বনাম PHPTRAVELS মডিউল
দুটোই একই Amadeus অ্যাকাউন্ট ব্যবহার করে। পার্থক্য হলো আপনার টিম এর চারপাশে কতটা লেখে ও রক্ষণাবেক্ষণ করে।
| কাজ | সরাসরি API বিল্ড | PHPTRAVELS |
|---|---|---|
| অথেনটিকেশন | সরাসরি API বিল্ডটোকেন অনুরোধ ও নবায়ন আপনার ডেভেলপাররা লেখেন | PHPTRAVELSতিনটি admin ফিল্ড থেকে মডিউল সামলায় |
| সার্চ ফলাফল | সরাসরি API বিল্ডঅফার ডেটা নিজের ফলাফল পেজে ম্যাপ করতে হয় | PHPTRAVELSঅফার বিদ্যমান ফ্লাইট সার্চে দেখায় |
| বুকিং | সরাসরি API বিল্ডযাত্রী ফর্ম ও অর্ডার কল শূন্য থেকে তৈরি | PHPTRAVELSCreate Orders চেকআউট ও পেমেন্টের সাথে যুক্ত |
| টেস্ট ও লাইভ | সরাসরি API বিল্ডপ্রতিটি এনভায়রনমেন্টের আলাদা কনফিগারেশন | PHPTRAVELSএকটি Dev mode সুইচ |
| মার্কআপ ও বুকিং | সরাসরি API বিল্ডডিজাইন ও তৈরি করতে হবে এমন ব্যাক অফিস | PHPTRAVELSফ্লাইট admin-এ অন্তর্ভুক্ত |
| সেটআপ ধাপ | সরাসরি API বিল্ডআপনার টিম লেখে ও হালনাগাদ রাখে | PHPTRAVELSdocs.phptravels.com-এ প্রকাশিত গাইড |
ব্যবহারের ক্ষেত্র
কারা Amadeus মডিউল চালু করে
অনলাইন ট্রাভেল এজেন্সি
Amadeus কনটেন্টে পাবলিক ফ্লাইট সার্চ, আপনার মার্কআপ ও চেকআউটসহ।
B2B এজেন্ট নেটওয়ার্ক
সাব-এজেন্টরা আপনার পোর্টালে আপনার রেটে Amadeus ভাড়া বুক করে।
ট্রাভেল ম্যানেজমেন্ট কোম্পানি
কর্পোরেট বুকাররা আপনার হোস্ট ও নিয়ন্ত্রিত প্ল্যাটফর্মে Amadeus ভাড়া খোঁজেন।
কেন PHPTRAVELS
এমন কানেক্টর যা আপনি পড়তে, বদলাতে ও হোস্ট করতে পারেন
সোর্স কোড অন্তর্ভুক্ত
বাণিজ্যিক লাইসেন্সে সেলফ-হোস্টেড, তাই ডেভেলপাররা Amadeus মডিউল বাড়াতে পারেন।
নথিভুক্ত সেটআপ
প্রতিটি ধাপ, ফিল্ড ও ত্রুটির কারণ docs.phptravels.com-এ লেখা আছে।
24টি ভাষা
আপনার বাজারের ভাষায় Amadeus ভাড়া দেখান, ডান থেকে বাম লিপিসহ।
B2C ও B2B
পাবলিক সাইট ও এজেন্ট পোর্টালের জন্য একটি ইনস্টলেশন।
প্রশ্নোত্তর
Amadeus কানেক্টর নিয়ে প্রশ্ন
Amadeus মডিউল সেট করার সময় টিমগুলো যা জানতে চায়।
সেলসের সাথে কথা বলুনএটি একটি তৈরি ফ্লাইট মডিউল। আপনি Amadeus for Developers-এ অ্যাপ তৈরি করেন, admin-এ এর ক্রেডেনশিয়াল দেন, এবং Amadeus অফার আপনার ফ্লাইট সার্চে দেখা যায়, বুকিং হয় Flight Create Orders দিয়ে।
Amadeus মডিউল Enterprise প্ল্যানে পাওয়া যায়, যা মূল্য পেজে $9999 এককালীন পেমেন্ট হিসেবে দেওয়া। আপনার Amadeus অ্যাকাউন্ট ও তার বাণিজ্যিক শর্ত আলাদা এবং Amadeus-এর সাথে ঠিক হয়।
client_credentials grant type, একটি client ID ও একটি client secret। অ্যাপ তৈরি করলে Amadeus sandbox কী দেয় এবং production অনুরোধ অনুমোদনের পর production কী দেয়।
মডিউলটি travel.api.amadeus.com/v2/ ব্যবহার করে। কিছু অঞ্চলে এন্ডপয়েন্ট বা প্যারামিটার আলাদা, তাই আগে অ্যাকাউন্ট যাচাই করুন; অন্য এন্ডপয়েন্ট কাস্টম ডেভেলপমেন্টে যোগ করা যায়।
দুটোই, আপনার Amadeus অ্যাপে চালু API অনুযায়ী। Flight Offers Search ফলাফল দেয়, আর বুকিংয়ের জন্য Flight Create Orders চালু থাকতে হবে।
নথিভুক্ত কানেক্টরটি ফ্লাইটের জন্য। Amadeus স্টে সাপ্লায়ার হিসেবেও তালিকাভুক্ত, তবে তার সেটআপ গাইড এখনো প্রকাশিত হয়নি, তাই হোটেলের পরিসর নিয়ে আমাদের টিমকে জিজ্ঞাসা করুন।
