iBusAPI

واجهة iBus البرمجية للنقل العام

المحطات والخطوط والجداول ومواعيد الوصول المباشرة والرسائل الرسمية عن تغييرات الحركة في المواصلات العامة في إسرائيل، بصيغة JSON عبر HTTPS. البيانات نفسها التي يستخدمها تطبيق iBus، للمشاريع ذات الطلب المقبول.

مركز تجاري عزريئيلي/طريق مناخم بيغين
محطة 21472
GET /api/transport/v2/stop/21472/arrivals?limit=6&lang=ar
  1. 271جادة يروشلايم/خليج شلومومباشر אגדالآن
  2. 42ת.רק''ל הקוממיות/דרך בגיןحسب الجدول דן17:01
رد نموذجي (محفوظ، ليس مباشرًا)
عرض JSON لهذه الاستجابة
200 application/json
{
  "stopId": "21472",
  "updatedAt": "2026-10-21T17:16:22+03:00",
  "stale": false,
  "arrivals": [
    {
      "vehicle_ref": "AVEexampleVehicle01",
      "line_ref": "9877",
      "route_short_name": "271",
      "agency_id": "3",
      "agency_name": "אגד",
      "stop_point_ref": "21472",
      "direction_ref": "1",
      "dated_vehicle_journey_ref": "9719820",
      "data_frame_ref": "2026-10-21",
      "item_identifier": "1433250322",
      "confidence_level": "probablyReliable",
      "call_order": 17,
      "distance_from_stop_m": 6887,
      "latitude": 32.0769,
      "longitude": 34.792049,
      "bearing": 206.0,
      "velocity": 0.0,
      "motion": "stopped",
      "destination_name": "Yerushalayim Boulevard/Mifrats Shlomo",
      "destination_ref": "35810",
      "direction_text": null,
      "current_stop_name": null,
      "current_stop_code": "21472",
      "origin_aimed_departure_utc": "2026-10-21T13:45:00Z",
      "expected_arrival_utc": "2026-10-21T14:17:00Z",
      "aimed_arrival_utc": null,
      "recorded_at_utc": "2026-10-21T14:16:05Z",
      "expected_in_min": 0,
      "wheelchair_accessible": 1,
      "stops_remaining": 16,
      "freshness": {
        "state": "live",
        "age_sec": 17,
        "observed_at_utc": "2026-10-21T14:16:05Z"
      },
      "observation_age_sec": 17,
      "gtfs_trip_id": "8947270_211026",
      "gtfs_stop_sequence": 17,
      "dest_code": "35810",
      "dest_names": {
        "he": "שדרות ירושלים/מפרץ שלמה",
        "en": "Yerushalayim Boulevard/Mifrats Shlomo",
        "ar": "جادة يروشلايم/خليج شلومو"
      },
      "trust": {
        "v": 1,
        "observed_at_utc": "2026-10-21T14:16:05Z",
        "received_at_utc": "2026-10-21T14:16:22Z",
        "age_sec": 17,
        "freshness": "live",
        "identity": "exact",
        "position": "ok",
        "checks": {
          "motion": "ok",
          "time": "ok",
          "geometry": "unknown",
          "direction": "unknown"
        },
        "issues": [],
        "forecast": "source",
        "verdict": "live"
      },
      "vtok": "EXAMPLEpass1"
    },
    {
      "vehicle_ref": "AVEexampleVehicle02",
      "line_ref": "2454",
      "route_short_name": "42",
      "agency_id": "5",
      "agency_name": "דן",
      "stop_point_ref": "21472",
      "direction_ref": "1",
      "dated_vehicle_journey_ref": "3019375",
      "data_frame_ref": "2026-10-21",
      "item_identifier": "1433250318",
      "confidence_level": "probablyReliable",
      "call_order": 24,
      "distance_from_stop_m": 8190,
      "latitude": 32.080585,
      "longitude": 34.79604,
      "bearing": 248.0,
      "velocity": 0.0,
      "motion": "stopped",
      "destination_name": "ת.רק''ל הקוממיות/דרך בגין",
      "destination_ref": "36108",
      "direction_text": null,
      "current_stop_name": null,
      "current_stop_code": "21472",
      "origin_aimed_departure_utc": "2026-10-21T13:35:00Z",
      "expected_arrival_utc": "2026-10-21T14:17:00Z",
      "aimed_arrival_utc": null,
      "recorded_at_utc": "2026-10-21T14:14:15Z",
      "expected_in_min": 0,
      "wheelchair_accessible": 1,
      "stops_remaining": 23,
      "freshness": {
        "state": "scheduled_confirmed",
        "age_sec": 127,
        "observed_at_utc": "2026-10-21T14:14:15Z",
        "basis": "gtfs_confirmed_stale_observation",
        "scheduled_arrival_utc": "2026-10-21T14:01:54Z"
      },
      "observation_age_sec": 127,
      "stale_observation": true,
      "schedule_confirmed": true,
      "gtfs_trip_id": "3019266_211026",
      "gtfs_stop_sequence": 24,
      "gtfs_scheduled_arrival_utc": "2026-10-21T14:01:54Z",
      "gtfs_scheduled_departure_utc": "2026-10-21T14:01:54Z",
      "dest_code": "36108",
      "dest_names": {
        "he": "ת.רק''ל הקוממיות/דרך בגין",
        "en": "ת.רק''ל הקוממיות/דרך בגין",
        "ar": "ת.רק''ל הקוממיות/דרך בגין"
      },
      "trust": {
        "v": 1,
        "observed_at_utc": "2026-10-21T14:14:15Z",
        "received_at_utc": "2026-10-21T14:16:22Z",
        "age_sec": 127,
        "freshness": "scheduled_confirmed",
        "identity": "exact",
        "position": "ok",
        "checks": {
          "motion": "ok",
          "time": "ok",
          "geometry": "unknown",
          "direction": "unknown"
        },
        "issues": [],
        "forecast": "timetable",
        "verdict": "schedule"
      },
      "vtok": "EXAMPLEpass2"
    }
  ],
  "source": "siri",
  "server_now_utc": "2026-10-21T14:16:22Z",
  "freshness_contract": 1,
  "source_state": "ok"
}

ماذا يمكنك أن تحصل عليه#

الوصول#

تتصل عمليات الربط بالواجهة من خادم بمفتاح مشروع مقبول: Authorization: Bearer <المفتاح>. كيف تحصل على الوصول. الوظائف الشخصية لتطبيق iBus (المفضلة والإشعارات والمساعد ليئور) ليست جزءًا من هذه الواجهة؛ انظر الوصول والمفاتيح والخصوصية.

المفتاح مطلوب: منذ 24.10.2026 لا تجيب عمليات /api/transport/ إلا على الطلبات التي تحمل مفتاحًا (بدونه: 401 KEY_REQUIRED). العناوين القديمة بدون /transport ما زالت تجيب بدون مفتاح مؤقتًا (فترة انتقالية)؛ سنعلن عن نهايتها في صفحة الوصول مسبقًا.

طلبك الأول#

curl
curl -H "Authorization: Bearer $IBUS_API_KEY" "https://api.ibusisrael.online/api/transport/stops/search?q=Azrieli&limit=3&lang=en"

احفظ المفتاح على خادمك، مثلًا في متغير البيئة IBUS_API_KEY الذي تستخدمه كل الأمثلة.

يعرض الرد محطات مع رمزها العام واسمها وموقعها. بهذا الرمز يمكنك طلب مواعيد الوصول: يشرح دليل الطلب الأول ذلك خطوة بخطوة.

بيانات يمكن الاعتماد عليها#

كل صف مباشر يحمل freshness. فقط الصفوف التي فيها freshness.state = "live" هي توقعات مباشرة. لا تُعرض ملاحظة قديمة أبدًا على أنها مباشرة، ويُوسم الوقت المأخوذ من الجدول بذلك.

أوقات الجدول هي أوقات GTFS ليوم الخدمة، وقد تكون بعد 24:00. الشرح وكذلك المعرّفات في صفحة البيانات والوقت.

الحدود#

الحدود تخص المشروع: طلبات في الدقيقة (مع دفعة قصيرة) وفي اليوم وفي الشهر، وطلبات في الوقت نفسه، وميزانية منفصلة للعمليات الثقيلة. عند تجاوز حد يكون الرد 429 مع Retry-After. التفاصيل: الحدود والأخطاء.

للأدوات ومساعدي الذكاء الاصطناعي#

كل العمليات المنشورة#

الطريقةالعمليةالبيانات
GETحالة الخدمة
/api/transport/healthz
مرجعي
GETقواعد حداثة البيانات المباشرة
/api/transport/contract/freshness
مرجعي
GETالبحث عن المحطات بالاسم أو الرمز
/api/transport/stops/search
مرجعي
GETمحطة: الموقع والعنوان ومنطقة التعرفة
/api/transport/stop/{stopCode}
مرجعي
GETالمحطات حول نقطة
/api/transport/nearby_stops
مرجعي
GETأسماء ومواقع حتى 50 محطة
/api/transport/gw/stops/brief
مرجعي
GETمواعيد الوصول المتوقعة إلى محطة (مباشر)
/api/transport/v2/stop/{stopCode}/arrivals
مباشر
GETجدول مواعيد محطة ليوم خدمة
/api/transport/stop/{stopCode}/day_schedule
جدول المواعيد
GETمحطات قطارات إسرائيل
/api/transport/gw/rail/stations
مرجعي
GETالبحث عن الخطوط بالرقم
/api/transport/routes/search
مرجعي
GETمسار ومحطاته
/api/transport/line/{routeId}/full
مرجعي
GETشكل المسار على الطريق في تاريخ معيّن
/api/transport/gw/line/{routeId}/shape
مرجعي
GETكل تفرعات الخط الذي ينتمي إليه المسار
/api/transport/gw/line/{routeId}/variants
مرجعي
GETتفرعات خط حسب الرقم
/api/transport/gw/line/variants
مرجعي
GETرحلات المسار ليوم خدمة
/api/transport/line/{routeId}/day_schedule
جدول المواعيد
GETتنبيهات الخدمة
/api/transport/alerts
تنبيهات
GETتنبيه واحد
/api/transport/alerts/{alertId}
تنبيهات
GETتنبيهات تخص محطة
/api/transport/alerts/by-stop/{stopCode}
تنبيهات
GETتنبيهات تخص مسارًا
/api/transport/alerts/by-line/{agencyId}/{routeId}
تنبيهات
GETمشغلو النقل
/api/transport/agencies
مرجعي
GETإصدار قائمة المحطات
/api/transport/stops/version
مرجعي
GETهل التاريخ ضمن الجدول وهل هو يوم عادي
/api/transport/gw/service-day
مرجعي
GETما يراه الخادم عن طلبك (العنوان، المفتاح، المشروع)
/api/access/whoami
الوصول
الدليل
↑ ↓ تنقّلEnter فتحEsc إغلاق