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

بحث الطيران وحجزه، من البداية إلى النهاية

ابحث في الأسعار الحية عبر عدة مصادر، وأعد التحقق من السعر، واحجز وأصدر التذاكر. مجموعة واجهات REST واحدة، والأسعار بالدولار.

POST /Air/AirLowFareSearch
{
  "AdultCount": 1,
  "TravelPreference": { "CabinType": 3 },
  "OriginDestinationInformations": [
    { "OriginLocationCode": "TBS",
      "DestinationLocationCode": "DXB",
      "DepartureDateTime": "2026-11-14T00:00:00" }
  ]
}
نظرة عامة

محتوى شركات الطيران مبعثر وكل مصدر يتحدث بلهجته الخاصة. تُوحّد واجهة حجز الطيران هذه البحث وقواعد الأسعار والأمتعة والحجز والإصدار والاسترداد خلف عقد JSON متّسق.

خلف نقاط النهاية يعمل محرّك أسعار موحّد يتحدّث إلى أنظمة التوزيع العالمية وشركات الطيران الاقتصادية عبر عقد JSON واحد. تحصل على مسارات وقواعد أسعار وأمتعة وبيانات مقاعد متّسقة سواء جاء المحتوى من GDS أو من ربط مباشر مع شركة الطيران، فيتكامل تطبيق حجز الطيران أو وكالتك الإلكترونية مرّة واحدة ويتوسّع في كل مكان.

ما الذي تحصل عليه

1

ابحث عن أرخص مسار لكل مجموعة رحلات، أو استقبل النتائج عبر أحداث الخادم المدفوعة (SSE) لعرضٍ أوّليٍّ سريع.

2

أعِد التحقق من السعر قبل الحجز مباشرةً، ليكون السعر الذي تحصّله مطابقًا للسعر الفعلي.

3

تملك دورة الحياة كاملة: احجز مقعدًا، وأصدر التذكرة، ثم تابِع أو ألغِ أو استرد.

4

ابثّ المسارات عبر Server-Sent Events لعرض أوّل سريع على الخطوط البطيئة.

5

معالجة كاملة بعد الإصدار: جلب المستندات، الإلغاء ضمن المهلة (void)، والإلغاء والاسترداد.

كيف يسير التدفّق

01

Search

Post routes and dates, get priced itineraries back, or stream them over server-sent events.

02

Revalidate

Re-price the chosen itinerary right before booking so the fare you charge is the fare you get.

03

Book

Create the booking, hold the seats, and receive a booking reference.

04

Issue

Issue the ticket against your balance, then track, void, cancel, or refund.

أهم نقاط النهاية

POST/Air/AirLowFareSearchSearch the cheapest itinerary per flight group.
POST/Air/AirLowFareSearchStreamStream itineraries over server-sent events.
POST/Air/AirRevalidateRe-price and validate an itinerary before booking.
POST/Air/AirBookCreate the booking and hold seats.
POST/Air/AirTicketIssue the ticket for a booking.
GET/Air/AirBookingDetailsRetrieve a booking, its status, and documents.

الطلب والاستجابة

Request · POST /Air/AirLowFareSearch
{
  "AdultCount": 1,
  "TravelPreference": { "CabinType": 3 },
  "OriginDestinationInformations": [
    { "OriginLocationCode": "TBS",
      "DestinationLocationCode": "DXB",
      "DepartureDateTime": "2026-11-14T00:00:00" }
  ]
}
Response · 200 OK
{
  "itineraries": [
    {
      "fareCode": "TBSDXB-Y-412",
      "total": { "amount": 412.00, "currency": "USD" },
      "seatsRemaining": 5,
      "segments": [
        { "from": "TBS", "to": "DXB",
          "depart": "2026-11-14T09:40",
          "carrier": "EK", "flight": "2201" }
      ]
    }
  ]
}

ماذا تتضمّن الاستجابة

fareCode
Opaque identifier you pass to revalidate and book.
total
Final price with currency, already normalized to USD.
seatsRemaining
Bookable seats left at this fare.
segments
Each flight leg with carrier, flight number, times, and airports.
baggage
Included allowance and paid options per segment.
+1,000

شركة طيران

الأسئلة الشائعة

ماذا يُعيد بحث الطيران؟

مسارات مُسعّرة، كلٌّ منها بكود سعر، والقطاعات، والإجمالي بالدولار، والمقاعد المتبقية.

هل يمكنني استقبال النتائج بثًّا؟

نعم. تدفع واجهة البحث التزايدي المسارات عبر أحداث الخادم المدفوعة فور وصولها.

كيف أختبر بأمان؟

وجّه تطبيقك إلى البيئة التجريبية. البحث حقيقي، أما نداء الإصدار فيُحاكى مقابل رصيد منفصل.

هل تدعمون الاتجاه الواحد والذهاب والإياب وتعدّد المدن؟

نعم. أرسل زوجًا واحدًا أو أكثر من نقاط الانطلاق والوصول في جسم البحث نفسه؛ الاتجاه الواحد والذهاب والإياب وتعدّد المدن تستخدم الشكل نفسه.

كيف تُعالَج الاستردادات؟

ألغِ ضمن مهلة شركة الطيران، أو قدّم استردادًا بعد الإصدار. تُعيد الواجهة المبلغ القابل للاسترداد والحالة الناتجة.

ابنِ منتج سفرك على واجهة واحدة.

الربط مجاني. 1% لكل تذكرة مُصدَرة بحدٍّ أقصى 10 دولارات. تغطية حية للطيران والفنادق والأنشطة.