مرکز APIهای تأمین‌کنندگان و خدمات

APIهای سفر متصل به یک پلتفرم رزرو

همه راهنماهای API سفر این سایت در یک جا: محتوای GDS و ایرلاین‌ها، بدبانک‌ها و اکسترانت‌های هتل، تور، خودرو و ترانسفر، درگاه‌های پرداخت و ابزارهای بک‌آفیس. فهرست را بر اساس دسته فیلتر کنید، سه روش تأمین موجودی را مقایسه کنید و مسیر یک یکپارچه‌سازی را از کلیدهای سندباکس تا فروش واقعی دنبال کنید.

  • راهنماهای یکپارچه‌سازی بر اساس دسته
  • جریان جستجو، قیمت، رزرو، بلیت
  • API در برابر موتور رزرو در برابر GDS
  • میزبانی اختصاصی همراه با کد منبع

به‌طور خلاصه

APIهای سفر چه هستند و کجا جای می‌گیرند

سه اصطلاح در هر صفحه این مرکز تکرار می‌شود. پیش از انتخاب تأمین‌کننده، معنای هر یک را بدانید.

اگر با این موضوع تازه آشنا می‌شوید، از یکپارچه‌سازی API چیست شروع کنید و سپس توضیح فنی را در یکپارچه‌سازی API سفر بخوانید. فهرست کامل اتصال‌دهنده‌های آماده در همه یکپارچه‌سازی‌ها است و ماژول‌های رزروی که از آن‌ها استفاده می‌کنند در نمای کلی پلتفرم شرح داده شده‌اند.

  • API سفر

    یک نقطه پایانی برنامه‌نویسی که داده‌های قابل جستجوی سفر مانند موجودی، نرخ، قوانین و محتوا را برای پرواز، هتل، خودرو یا تور، معمولاً به صورت JSON یا XML برمی‌گرداند.

  • یکپارچه‌سازی API سفر

    اتصال نقطه پایانی یک تأمین‌کننده، GDS یا تجمیع‌کننده به موتور رزرو: احراز هویت، نگاشت فیلدها، فراخوانی‌های رزرو idempotent و سیاست‌های خطا و تلاش مجدد.

  • اتصال‌دهنده‌های با میزبانی اختصاصی

    PHPTRAVELS کد اتصال‌دهنده‌ها را همراه با مجوز تحویل می‌دهد، بنابراین تیم شما می‌تواند آداپتورهایی را که با هر تأمین‌کننده گفتگو می‌کنند بخواند، گسترش دهد و میزبانی کند.

توالی فراخوانی مشترک میان همه تأمین‌کنندگان

  1. 01جستجو
  2. 02قیمت و اعتبارسنجی مجدد
  3. 03رزرو
  4. 04بلیت یا تأیید

نام تأمین‌کنندگان و شکل پاسخ‌ها متفاوت است، اما هر اتصال‌دهنده در فهرست زیر بر همین توالی چهار فراخوانی منطبق است.

فهرست

APIهای سفر بر اساس دسته

برای کوتاه‌کردن فهرست یک دسته انتخاب کنید. هر مورد راهنمای اختصاصی آن تأمین‌کننده یا خدمت را باز می‌کند: چه چیزی برمی‌گرداند و چگونه در پلتفرم راه‌اندازی می‌شود.

GDS، ایرلاین‌ها و APIهای پرواز

20 راهنما

سامانه‌های توزیع جهانی، NDC، تجمیع‌کننده‌های ایرلاین‌های ارزان، کنسولیداتورها و سرویس‌های داده پرواز برای ماژول پرواز.

APIهای هتل، بدبانک‌ها و اکسترانت‌ها

15 راهنما

بدبانک‌های عمده، برنامه‌های همکاری OTA، اکسترانت‌ها و مدیران کانال که جستجوی هتل را با اتاق و نرخ پر می‌کنند.

تور، جاذبه‌ها، خودرو و ترانسفر

4 راهنما

بازارهای فعالیت، کارگزاران اجاره خودرو و تأمین‌کنندگان ترانسفر که خدمات جانبی را در کنار پرواز و اقامت اضافه می‌کنند.

سه روش تأمین موجودی

APIهای سفر در برابر موتور رزرو در برابر GDS API

تیم‌ها اغلب یک API مستقیم، یک موتور رزرو بسته‌بندی‌شده و یک قرارداد خام GDS را طوری می‌سنجند که انگار یک خرید واحدند. این‌ها مسائل متفاوتی را حل می‌کنند و معمولاً با هم ترکیب می‌شوند.

معیارAPIهای سفرموتور رزروGDS API
هدفAPIهای سفرداده و عملیات از طریق نقاط پایانیموتور رزروفرانت‌اند، قوانین کسب‌وکار و پرداخت نهاییGDS APIمحتوای پرواز و خدمات جانبی از کانال‌های قدیمی و NDC
دامنه محتواAPIهای سفرهتل، پرواز، خودرو، فعالیت، بدبانکموتور رزرواز جستجو تا پرداخت نهایی برای هر چیزی که متصل استGDS APIعمدتاً ایرلاین‌ها و خدمات جانبی آن‌ها
تلاش یکپارچه‌سازیAPIهای سفرمتوسط: نگاشت فیلد، idempotency، تلاش مجددموتور رزرومتوسط تا زیاد در ساخت از صفر؛ کم در PHPTRAVELSGDS APIزیاد: راه‌اندازی PCC، صف‌ها، گواهی و ممیزی
شرایط تجاریAPIهای سفربه ازای فراخوانی، مارک‌آپ یا صندلی، تعیین‌شده توسط تأمین‌کنندهموتور رزرومجوز یک‌بار پرداخت در PHPTRAVELS به‌علاوه کارمزد درگاهGDS APIقراردادهای GDS، مشوق‌ها و اهداف سگمنت
مناسب برایAPIهای سفرOTAها و DMCهایی که چند تأمین‌کننده را ترکیب می‌کنندموتور رزروفروش مستقیم با برند و قوانین خودتانGDS APIآژانس‌های پروازمحور و شرکت‌های مدیریت سفر
زمان ورود به بازارAPIهای سفرسریع، به محض صدور اعتبارنامه‌هاموتور رزرونصب، اتصال تأمین‌کنندگان، برندسازی و راه‌اندازیGDS APIطولانی‌ترین، چون ابتدا تأیید و گواهی لازم است

PHPTRAVELS ستون موتور رزرو است: APIهای تأمین‌کنندگان و هر قرارداد GDS به آن وصل می‌شوند، پس نرم‌افزار را یک بار می‌خرید و با رسیدن قراردادها فید اضافه می‌کنید. قیمت‌ها در قیمت‌ها است؛ بخش میزبانی در پیش‌نیازها توضیح داده شده است.

از کلیدها تا فروش واقعی

یک یکپارچه‌سازی API چگونه راه‌اندازی می‌شود

ریل زیر ترتیب کار برای هر تأمین‌کننده در فهرست است، همراه با درخواست و پاسخی که پلتفرم پس از فعال‌شدن اتصال‌دهنده مبادله می‌کند.

  1. 01

    اعتبارنامه‌ها

    قرارداد تأمین‌کننده را امضا کنید و کلیدهای سندباکس، نقاط پایانی و مستندات را دریافت کنید.

  2. 02

    اتصال سندباکس

    کلیدها را در پنل مدیریت وارد کنید، اولین جستجو را اجرا کنید و مطمئن شوید اتصال‌دهنده پاسخ را می‌خواند.

  3. 03

    نگاشت محتوا

    کدهای تأمین‌کننده را با داده‌های اصلی پلتفرم تطبیق دهید: فرودگاه‌ها، شناسه هتل‌ها، نوع وعده‌ها، کلاس خودروها.

  4. 04

    مارک‌آپ‌ها و قوانین

    مارک‌آپ، مالیات، کارمزد و قوانین ارزی را برای هر آژانس، هر نماینده B2B یا هر گروه مشتری تنظیم کنید.

  5. 05

    رزروهای آزمایشی

    سناریوهای گواهی تأمین‌کننده را کامل کنید: رزرو، تغییر، لغو و مطابقت با کنسول آزمایشی آن‌ها.

  6. 06

    کلیدهای تولید

    به اعتبارنامه‌های واقعی بروید، تأمین‌کننده را برای سایت عمومی و پورتال B2B فعال کنید و اولین رزروها را پایش کنید.

یک فراخوانی اعتبارسنجی مجدد، همان‌طور که پلتفرم ارسال می‌کند

>درخواستPOST /api/v1/hotels/price
{  "supplier": "hotelbeds",1  "env": "production",1  "rateKey": "HB-20261112-118742-DBL-BB",  "occupancy": { "rooms": 1, "adults": 2 },  "currency": "USD",  "markupRule": "b2c-default"2}
<پاسخ200 OK
{  "status": "available",  "net": 184.00,2  "sell": 206.08,2  "currency": "USD",  "cancellation": { "deadline": "2026-11-09", "fee": 184.00 },  "hold": "PT-HLD-7731",3  "expiresIn": 9003}
  1. 1

    کلیدهای تأمین‌کننده به ازای هر محیط ذخیره می‌شوند و هرگز در بدنه درخواستی که به مشتری می‌رسد قرار نمی‌گیرند.

  2. 2

    قیمت خالص و قیمت فروش با هم منتقل می‌شوند؛ نام قانون مارک‌آپ به بک‌آفیس می‌گوید چرا متفاوت‌اند.

  3. 3

    مرجع نگهداری، فراخوانی رزرو را در صورت تلاش مجدد مشتری برای پرداخت idempotent نگه می‌دارد.

  4. مشاهده راهنمای یکپارچه‌سازی

انتخاب بر اساس مدل کسب‌وکار

هر نوع کسب‌وکار ابتدا کدام APIهای سفر را متصل می‌کند

فهرست طولانی است چون کسب‌وکارهای سفر متفاوت‌اند. این‌ها ترکیب‌های آغازین معمولی هستند که در زمان راه‌اندازی می‌بینیم.

  • 01

    آژانس مسافرتی آنلاین

    یک فید GDS یا NDC برای پرواز، یک یا دو بدبانک برای هتل، یک کارگزار خودرو و یک درگاه کارت. اول گستردگی، سپس قراردادهای مستقیم.

  • 02

    شرکت مدیریت مقصد

    موجودی اختصاصی بارگذاری‌شده در پنل مدیریت، یک بدبانک برای پرکردن خلأها، بازار تور و ترانسفر. پرواز اغلب بعداً از طریق کنسولیداتور اضافه می‌شود.

  • 03

    مدیریت سفرهای سازمانی

    محتوای GDS با نرخ‌های توافقی، برنامه هتلی از طریق اکسترانت یا بدبانک، قوانین تأیید و خروجی حسابداری.

  • 04

    کنسولیداتور یا عمده‌فروش B2B

    چند منبع پرواز با مارک‌آپ به ازای هر زیرنماینده، کیف پول نماینده، پرداخت با حواله بانکی و درگاه، و فید حسابداری.

هر مدل در صفحه خودش شرح داده شده است: آژانس‌های آنلاین سفر، DMCها و سفرهای سازمانی؛ بخش اعتبار زیرنمایندگان عمده‌فروش در کیف پول نمایندگان آمده است. لایه وایت‌لیبل که این فیدها را به شرکا توزیع می‌کند در پرتال B2B با برند شما توضیح داده شده است.

پرسش‌ها

پاسخ به پرسش‌ها درباره APIهای سفر

پاسخ‌های کوتاه به آنچه خریداران پیش از انتخاب تأمین‌کننده می‌پرسند.

گفتگو با فروش

APIهای سفر نقاط پایانی هستند که موجودی زنده، قیمت‌ها، قوانین و عملیاتی مانند جستجو، اعتبارسنجی مجدد، رزرو و لغو را از تأمین‌کنندگان، ارائه‌دهندگان GDS و تجمیع‌کننده‌ها در دسترس می‌گذارند. پلتفرم رزرو آن‌ها را فراخوانی می‌کند و پاسخ‌ها را به نتیجه جستجو، سبد و رزرو تأییدشده تبدیل می‌کند.

احراز هویت با کلیدهای تأمین‌کننده، نگاشت کدهای آن به داده‌های اصلی شما، فراخوانی جستجو، قیمت و رزرو به ترتیب، مدیریت خطاها و تلاش‌های مجدد بدون رزرو تکراری و تحویل نتیجه به پرداخت، واچر و حسابداری. در PHPTRAVELS اتصال‌دهنده‌ها این کار را انجام داده‌اند؛ کار شما اعتبارنامه‌ها، نگاشت و قوانین است.

بله. پلتفرم با میزبانی اختصاصی است و کد منبع تحت مجوز تجاری ارائه می‌شود، بنابراین توسعه‌دهندگان شما می‌توانند هر آداپتور را بخوانند، تأمین‌کننده‌ای را که هنوز در فهرست نیست اضافه کنند یا نحوه نگاشت محتوای یک اتصال‌دهنده موجود را تغییر دهند.

معمولاً ترکیبی به‌جای یک فید: یک تجمیع‌کننده ایرلاین‌های ارزان برای گستردگی، محتوای NDC یا GDS برای ایرلاین‌های کامل‌خدمت و صدور بلیت، و یک کنسولیداتور جایی که قرارداد ایرلاین خودتان را ندارید. گروه پرواز در فهرست، راهنمای هر گزینه را دارد.

چندین مورد به ازای هر ماژول. پلتفرم از هر تأمین‌کننده فعال پرس‌وجو می‌کند، نتایج را بر اساس شناسه اصلی ادغام می‌کند، تکراری‌ها را حذف می‌کند و پیش از نمایش قیمت قانون مارک‌آپ شما را اعمال می‌کند؛ پس افزودن بدبانک دوم یا منبع پرواز دوم یک تغییر پیکربندی است، نه بازسازی.

خود APIها را تأمین‌کنندگان قیمت‌گذاری می‌کنند، معمولاً به ازای فراخوانی، به ازای رزرو یا با توافق مارک‌آپ؛ برخی با برنامه همکاری رایگان‌اند. نرم‌افزار PHPTRAVELS که آن‌ها را متصل می‌کند، مجوز یک‌بار پرداخت از ۲٬۴۹۹ دلار است، همان‌طور که در صفحه قیمت‌ها آمده است.