مرجع API

مرحباً بك في توثيق واجهات شام باص.

نظرة عامة

Base URL (customer web): https://shambus.com/api
Base URL (local development): http://localhost:3000/api

بعض المسارات تستخدم cookies آمنة من نوع HttpOnly إلى جانب الترويسات التقليدية. لذلك لا تفترض أن جميع الجلسات تدار عبر Bearer فقط.

نقاط النهاية الرئيسية

المدن والمسارات

Method	Endpoint	الوصف
GET	/api/cities	جلب قائمة المدن
GET	/api/routes/popular	المسارات الشائعة وفق البيانات الحالية

الرحلات

Method	Endpoint	الوصف
GET	/api/trips	البحث عن الرحلات
GET	/api/trips/:id	تفاصيل رحلة
GET	/api/trips/:id/seats	المقاعد أو بيانات المقاعد الحالية

الحجوزات

Method	Endpoint	الوصف
POST	/api/bookings	إنشاء حجز جديد
GET	/api/bookings	عرض الحجوزات
GET	/api/bookings/:id	تفاصيل حجز
POST	/api/bookings/:id/cancel	محاولة إلغاء الحجز

الأقسام

• المصادقة
• نقاط النهاية
• Webhooks

حالة المرجع

• تم التحقق يدوياً من قسم واجهات العملاء لمسارات المصادقة الأساسية في هذا التحديث.
• بقية صفحات API تُعامل كمرجع عملي ويجب مطابقتها مع route handlers عند أي تغيير عقدي مهم.