رابط پرواز

تقویم نرخ

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 ارزان‌ترین نرخ ذخیره‌شده در حافظه نهان را برای هر روز مسیر، به ارز شما و همراه با میزان تازگی داده، برمی‌گرداند. returnFrom / returnTo را برای مبالغ رفت‌وبرگشت هر جفت تاریخ و cabin را برای محدود کردن کلاس اضافه کنید. این داده از حافظه نهان قیمت ما ارائه می‌شود — فوری است و هرگز جست‌وجوی تأمین‌کننده حساب نمی‌شود — پس از آن برای نمایش تقویم یا نوار «ارزان‌ترین روزها» پیش از جست‌وجوی واقعی استفاده کنید.

جست‌وجو

POST /v1/flights/search با یک بخش مسیر برای یک‌طرفه، دو بخش برای رفت‌وبرگشت و تا شش بخش برای چندمقصدی؛ تعداد مسافران بر اساس نوع؛ و به‌صورت اختیاری کابین و حداکثر تعداد توقف (maxStops). با wait=true پاسخ پس از پاسخ همهٔ تأمین‌کنندگان شامل همهٔ پیشنهادهاست؛ با wait=false یک searchId دریافت می‌کنید و GET /v1/flights/search/{searchId} را با یک cursor پرس‌وجو می‌کنید تا complete برابر true شود.

هر پیشنهاد یک offerId مبهم، مبلغ کل به ارز شما همراه با تفکیک برای هر مسافر، بخش‌های مسیر ← سگمنت‌ها (شرکت هواپیمایی، شماره پرواز، زمان‌ها، هواپیما، کابین، بار)، خلاصه شرایط نرخ و زمان انقضا دارد. پیشنهادها در طول عمر نشست جست‌وجو (حدود 20 دقیقه) معتبرند.

قیمت و قوانین

POST /v1/flights/offers/{offerId}/price درست پیش از قطعی کردن، نرخ را با تأمین‌کننده دوباره اعتبارسنجی می‌کند و قیمت تأییدشده، مالیات‌ها و فیلدهای مسافری را که ایرلاین لازم دارد (مدارک، تاریخ تولد، باشگاه مسافران) برمی‌گرداند. GET .../fare-rules متن جریمه‌ها را برمی‌گرداند؛ GET .../ancillaries بار و گزینه‌های پولی قابل افزودن به سفارش را فهرست می‌کند.

خدمات جانبی (بار اضافه)

GET /v1/flights/offers/{offerId}/ancillaries موارد اضافه پولی را که ایرلاین روی آن نرخ ارائه می‌کند فهرست می‌کند — در حال حاضر سهمیه‌های بار تحویلی اضافه، هر کدام با یک key، تعداد قطعه / وزن و قیمت برای هر مسافر. پولی یعنی جدا از نرخ قیمت‌گذاری و همراه سفارش صورت‌حساب می‌شوند، برخلاف سهمیه بار رایگانی که روی خود پیشنهاد نمایش داده می‌شود.

برای خرید آن‌ها، ancillaries[] را به POST /v1/flights/orders اضافه کنید: برای هر مورد اضافه یک ورودی با key و passengerIndex (اندیس از 0 در passengers). این موارد همراه سفارش قیمت‌گذاری، رزرو و صادر می‌شوند و در مبالغ بلیت سفارش نمایش داده می‌شوند. به سفارشی که بلیتش صادر شده نمی‌توان مورد اضافه افزود؛ انتخاب صندلی هم از همین الگو پیروی خواهد کرد.

{
  "offerId": "fo_7Gk2Qp9LcKM5aGqrMQOIzJko",
  "passengers": [{ "type": "ADT", "gender": "M", "firstName": "SAM", "lastName": "TRAVELLER", "dateOfBirth": "1990-05-04" }],
  "contact": { "email": "[email protected]", "phone": "+971501234567" },
  "ancillaries": [{ "key": "BAG20-1", "passengerIndex": 0 }]
}

ایجاد سفارش

POST /v1/flights/orders با offerId، مسافران (نام مطابق گذرنامه، نوع، تاریخ تولد، مدرک برای مسیرهای بین‌المللی)، اطلاعات تماس و ancillaries[] اختیاری (بالا را ببینید)؛ یک Idempotency-Key هم اضافه کنید. یک orderId، PNR ایرلاین، مهلت صدور بلیت و وضعیت held دریافت می‌کنید. در محیط آزمایشی سفارش به سیستم آزمایشی تأمین‌کننده می‌رود و هیچ هزینه‌ای کسر نمی‌شود؛ در محیط عملیاتی مبلغ از سپرده رزرو می‌شود.

صدور بلیت

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key الزامی است) بلیت‌های الکترونیکی را صادر می‌کند و شماره بلیت هر مسافر را برمی‌گرداند. هر زمان سفارش را با GET /v1/flights/orders/{orderId} بخوانید؛ وضعیت به ترتیب held → issued → cancelled/refunded تغییر می‌کند.

ابطال، لغو و استرداد

GET /v1/flights/orders/{orderId}/refund-quote می‌گوید لغو طبق قوانین نرخ چه مبلغی برمی‌گرداند (ابطال در همان روز معمولاً رایگان است). POST /v1/flights/orders/{orderId}/cancel آن را قطعی می‌کند؛ مبلغ استرداد به دفتر حساب سپرده شما بازمی‌گردد و در پورتال توسعه‌دهندگان قابل مشاهده است.