فهرست یکپارچه‌سازی‌ها
یکپارچهسازی Amadeus API: کانکتور پرواز، راهاندازی گام‌به‌گام
ماژول Amadeus جستجوی پرواز PHPTRAVELS را به Amadeus Enterprise متصل میکند. یک اپ ثبت کنید، سه اطلاعات احراز هویت را در پنل مدیریت وارد کنید، در حالت توسعه تست کنید و پس از تأیید حساب توسط Amadeus به production بروید.
- کانکتور پلن Enterprise
- OAuth2 client credentials
- توسعه و production
- راهنمای راهاندازی منتشرشده
راهاندازی کانکتور
از اپ Amadeus تا نتایج زنده پرواز در پنج گام
کانکتور یک ماژول آماده است، پس راهاندازی استاندارد به نوشتن کد نیاز ندارد. شما حساب Amadeus و شرایط تجاری خود را می‌آورید و ماژول احراز هویت، جستجوی پرواز و ایجاد سفارش را درون ماژول پرواز PHPTRAVELS انجام میدهد.
- با پلن Enterprise که ماژول Amadeus را دارد شروع کنید
- در Amadeus for Developers ثبت‌نام کنید و اپی با Flight Offers Search و Flight Create Orders بسازید
- grant type، client ID و client secret را در بخش ماژول‌های پنل وارد کنید و Dev mode را روشن بگذارید
- در سایت خود پرواز جستجو کنید و لوگوی Amadeus را زیر دکمه «همین حالا رزرو کنید» ببینید
- کلیدهای production را درخواست کنید، جایگزین کلیدهای sandbox کنید و Dev mode را روی production بگذارید
- Dev mode
- توسعه
- Endpoint
- travel.api.amadeus.com/v2/
- c1 · grant_type
- client_credentials
- c2 · client_id
- ••••••••••7Kq2
- c3 · client_secret
- ••••••••••
کانکتور چه میکند
پیشنهادهای Amadeus در جستجو، سفارش‌ها در پنل
دو API از Amadeus ماژول را به کار می‌اندازند: یکی پیشنهادهای پرواز را به صفحه نتایج برمی‌گرداند و دیگری هنگام پرداخت مسافر رزرو را ایجاد میکند.
- APIلندن به نیویورک · مستقیماکونومی · 8 ساعت 05 دقیقه · 1 چمدان تحویلی$۴۸۶برای هر بزرگسال
- v2لندن به نیویورک · 1 توقفاکونومی · 11 ساعت 20 دقیقه از طریق دوبلین · 1 چمدان تحویلی$۴۱۲برای هر بزرگسال
- لندن به نیویورک · مستقیمبیزینس · 7 ساعت 55 دقیقه · 2 چمدان تحویلی$۲٬۱۴۰برای هر بزرگسال
Flight Offers Search و Flight Create Orders
Offers Search نتایج را پر میکند و Create Orders پیشنهاد انتخاب‌شده را به رزرو تبدیل میکند. برای جستجو و رزرو هر دو را در اپ Amadeus فعال کنید.
احراز هویت OAuth2
ماژول با grant نوع client_credentials و با client ID و secret واردشده در پنل، توکن دسترسی درخواست میکند.
حالت‌های توسعه و production
یک تنظیم Dev mode تعیین میکند درخواست‌ها از کلیدهای sandbox استفاده کنند یا از کلیدهای production تأییدشده.
Endpoint نسخه Enterprise
ماژول بر پایه travel.api.amadeus.com/v2/ ساخته شده است. برخی مناطق endpoint دیگری دارند، پس پیش از وارد کردن کلیدها endpoint خود را بررسی کنید.
نمایش منبع در هر نتیجه
لوگوی Amadeus زیر دکمه «همین حالا رزرو کنید» نشان میدهد کدام نرخ‌ها از Amadeus آمده‌اند تا اتصال را با یک نگاه بررسی کنید.
علت‌های شناخته‌شده خطا
بیشتر خطاها ناشی از اطلاعات احراز هویت نادرست، حالتی که با کلیدها نمی‌خواند یا سرویس API غیرفعال در داشبورد Amadeus است.
جریان درخواست
در هر جستجوی Amadeus چه اتفاقی می‌افتد
همین ترتیب در توسعه و production اجرا میشود؛ فقط کلیدها و تنظیم Dev mode تغییر می‌کنند.
احراز هویت
client ID و secret شما با یک توکن دسترسی مبادله میشوند.
جستجو
Flight Offers Search نرخ‌ها را برای مسیر، تاریخ‌ها و مسافران برمی‌گرداند.
نمایش
پیشنهادها با مارک‌آپ شما کنار نتایج سایر تأمین‌کنندگان متصل نمایش داده میشوند.
سفارش
Flight Create Orders پیشنهاد انتخاب‌شده را با اطلاعات مسافر رزرو میکند.
ثبت
رزرو در پنل ذخیره میشود و تأییدیه ایمیل میشود.
جایگاه Amadeus
حساب Amadeus شما، APIهای دیگر پرواز و توسعه سفارشی
ماژول Amadeus یکی از چند کانکتور پرواز است و هر کدام با اطلاعات احراز هویت خود در همان جستجو کار می‌کنند.
حساب Amadeus Enterprise شما
Amadeus پس از بررسی کاربرد، ثبت شرکت و وب‌سایت شما کلیدهای production را صادر میکند و شما شرایط تجاری آن را می‌پذیرید.
کانکتورهای دیگر پرواز
Duffel، Kiwi یا تأمین‌کنندگان دیگر پرواز را از فهرست یکپارچه‌سازی‌ها اضافه کنید و نرخ‌ها را در یک فهرست مقایسه کنید.
Endpointها و APIهای دیگر
یک endpoint منطقه‌ای Amadeus یا APIای که ماژول هنوز از آن استفاده نمی‌کند، به‌صورت توسعه سفارشی قابل افزودن است.
تأمین‌کنندگان پرواز قابل اتصال:
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
پنل مدیریت
رزروهای Amadeus را از همان پنل مدیریت کنید
پس از وارد کردن کلیدها، نرخ‌های Amadeus از همان قوانینی پیروی می‌کنند که برای هر تأمینکننده پرواز دیگر دارید.
مارک‌آپ پرواز
مارک‌آپ ثابت یا درصدی اضافه کنید تا نرخ‌های Amadeus قیمت فروش شما را نشان دهند.
فهرست رزروها
رزروهای Amadeus با اطلاعات مسافر و وضعیت در صفحه رزروهای پرواز قرار می‌گیرند.
نمایندگان B2B
نمایندگان در پورتال نمایندگان با نرخ‌های خود نرخ‌های Amadeus را جستجو و رزرو می‌کنند.
پرداخت‌ها
مسافران از طریق درگاه‌های فعال‌شده و نمایندگان از کیف پول خود پرداخت می‌کنند.
کلیدها روی سرور شما
اطلاعات احراز هویت در پنل خودمیزبان شما ذخیره میشود، نه روی یک پلتفرم مشترک.
تیکت پشتیبانی
اگر اتصال یا رزروی به کمک ما نیاز داشت، در app.phptravels.com تیکت باز کنید.
مقایسه
کدنویسی مستقیم روی Amadeus در برابر ماژول PHPTRAVELS
هر دو از یک حساب Amadeus استفاده می‌کنند. تفاوت در میزان کدی است که تیم شما پیرامون آن می‌نویسد و نگه می‌دارد.
| کار | ساخت مستقیم API | PHPTRAVELS |
|---|---|---|
| احراز هویت | ساخت مستقیم APIدرخواست و تمدید توکن را توسعه‌دهندگان شما می‌نویسند | PHPTRAVELSماژول با سه فیلد پنل انجام میدهد |
| نتایج جستجو | ساخت مستقیم APIنگاشت داده پیشنهادها به صفحه نتایج خودتان | PHPTRAVELSپیشنهادها در جستجوی پرواز موجود نمایش داده میشوند |
| رزرو | ساخت مستقیم APIفرم مسافر و فراخوانی سفارش از صفر | PHPTRAVELSCreate Orders متصل به تسویه و پرداخت |
| تست و اجرا | ساخت مستقیم APIپیکربندی جدا برای هر محیط | PHPTRAVELSیک کلید Dev mode |
| مارک‌آپ و رزروها | ساخت مستقیم APIپنلی که باید طراحی و ساخته شود | PHPTRAVELSدر پنل پرواز موجود است |
| گام‌های راهاندازی | ساخت مستقیم APIتیم شما می‌نویسد و به‌روز نگه می‌دارد | PHPTRAVELSراهنمای منتشرشده در docs.phptravels.com |
کاربردها
چه کسانی ماژول Amadeus را فعال می‌کنند
آژانس‌های مسافرتی آنلاین
جستجوی عمومی پرواز روی محتوای Amadeus با مارک‌آپ و تسویه خودتان.
شبکه‌های نمایندگی B2B
زیرنمایندگان از پورتال شما با نرخ‌های شما نرخ‌های Amadeus را رزرو می‌کنند.
شرکت‌های مدیریت سفر
رزروکنندگان سازمانی نرخ‌های Amadeus را روی پلتفرمی که شما میزبانی و کنترل میکنید جستجو می‌کنند.
چرا PHPTRAVELS
کانکتوری که می‌توانید بخوانید، تغییر دهید و میزبانی کنید
شامل کد منبع
خودمیزبان با مجوز تجاری، تا توسعه‌دهندگان ماژول Amadeus را گسترش دهند.
راهاندازی مستند
هر گام، فیلد و علت خطا در docs.phptravels.com نوشته شده است.
24 زبان
نرخ‌های Amadeus را به زبان بازارهای خود نمایش دهید، از جمله زبان‌های راست‌به‌چپ.
B2C و B2B
یک نصب برای سایت عمومی و پورتال نمایندگان.
پرسش‌های متداول
پرسش‌های کانکتور Amadeus
آنچه تیم‌ها هنگام راهاندازی ماژول Amadeus می‌پرسند.
گفتگو با فروشیک ماژول پرواز آماده است. در Amadeus for Developers اپ میسازید، اطلاعات احراز هویت آن را در پنل وارد میکنید و پیشنهادهای Amadeus در جستجوی پرواز ظاهر میشوند و رزروها با Flight Create Orders ایجاد میشوند.
ماژول Amadeus با پلن Enterprise ارائه میشود که طبق صفحه قیمتها پرداخت یکباره $9999 است. حساب Amadeus و شرایط تجاری آن جداست و با Amadeus توافق میشود.
grant type از نوع client_credentials، یک client ID و یک client secret. Amadeus هنگام ساخت اپ کلیدهای sandbox و پس از تأیید درخواست production کلیدهای production را صادر میکند.
ماژول از travel.api.amadeus.com/v2/ استفاده میکند. برخی مناطق endpoint یا پارامترهای متفاوت دارند، پس ابتدا حساب خود را بررسی کنید؛ endpointهای دیگر با توسعه سفارشی قابل افزودناند.
هر دو، بسته به APIهای فعال در اپ Amadeus. Flight Offers Search نتایج را میدهد و برای رزرو باید Flight Create Orders فعال باشد.
کانکتور مستند برای پرواز است. Amadeus بهعنوان تأمینکننده اقامت هم فهرست شده، اما راهنمای راهاندازی آن هنوز منتشر نشده است؛ درباره دامنه هتل از تیم ما بپرسید.
بیشتر بدانید