واجهة بيانات رحلات ايليا (Public Flight API)

المسارات (Endpoints)

• GET /api/public/flights?from=NJF&to=MHD&date=YYYY-MM-DD — رحلات مسار وتاريخ (بدون date = أقرب يوم متاح).
• GET /api/public/flights/cheapest?from=NJF&to=MHD — أرخص سعر إجمالي + أرخص سعر لكل يوم (١٥ يوماً).
• GET /api/public/destinations — الوجهات المخدومة من النجف.
• GET /api/public/flights/health — حالة توفّر مصدر الأسعار.

المطارات المدعومة

المنشأ: النجف (NJF). الوجهات: مشهد MHD، طهران IKA، رشت RAS، جرجان GBT، أصفهان IFN (والعكس).

التفاصيل التقنية

• العملة: الدينار العراقي (IQD) دائماً.
• صيغة التاريخ: YYYY-MM-DD (المنطقة الزمنية Asia/Baghdad؛ وقت الإقلاع بإزاحة مطار المنشأ).
• الصيغة: JSON بترميز UTF-8، مع ترويسة Access-Control-Allow-Origin: *.
• حدود الاستخدام: ~٦٠ طلباً/دقيقة لكل IP (يُعاد 429 عند التجاوز).
• الكاش: حتى ٥ دقائق (Cache-Control: public, max-age=300)؛ كل استجابة تحمل last_updated وprice_valid_until.
• طزاجة البيانات: الأسعار استرشادية؛ عند تعذّر التحديث تُرفع stale: true؛ لا تُعرض أسعار منتهية كأنها نهائية.
• المصدر والنسب: "source": "Elia Iraq Travel" — يُرجى ذكر المصدر ورابط الحجز الرسمي عند الاقتباس.
• الخصوصية: لا تُكشف بيانات عملاء ولا مفاتيح مزوّدين؛ للقراءة فقط.

مثال استجابة

{
  "success": true,
  "source": "Elia Iraq Travel",
  "currency": "IQD",
  "origin": "NJF",
  "destination": "MHD",
  "date": "2026-10-22",
  "last_updated": "2026-10-21T00:00:00Z",
  "price_valid_until": "2026-10-21T00:05:00Z",
  "flights": [
    {
      "offer_id": "ab12cd34ef56",
      "airline": "...",
      "flight_number": "...",
      "origin": "NJF",
      "destination": "MHD",
      "departure_local": "2026-10-22T17:00:00+03:00",
      "arrival_local": null,
      "flight_type": "direct",
      "seats_available": 6,
      "availability": "available",
      "price": 0,
      "currency": "IQD",
      "price_valid_until": "2026-10-21T00:05:00Z",
      "booking_url": "https://ilyaiq.com.iq/book/"
    }
  ]
}

ملاحظة: حقول مثل arrival_local وfare_class وbaggage_allowance تكون null حين لا يوفّرها المصدر — ولا تُختلق. تُؤكَّد تفاصيل الأمتعة والسعر النهائي عند الحجز.

الحجز الرسمي

كل الأسعار تقود إلى الحجز الرسمي عبر موقع ايليا أو بوت تليجرام. تنطلق رحلات ايليا من مطار النجف الأشرف الدولي.

صفحات الأسعار المقروءة: كل المسارات · شركات الطيران.