واجهة الطيران

تقويم الأسعار

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 ينفّذه؛ ويُقيَّد المبلغ المسترد في كشف حساب وديعتك، ويظهر في بوابة المطوّرين.