MASAR DEVELOPER PLATFORM
واجهة مسار للمطورين
مرجع التكامل الرسمي لتطبيقات وأنظمة مؤسسات النقل. ابدأ بمفتاح محدود الصلاحيات، ثم استخدم موارد القراءة الموثقة بأمان.
v1.0Read-onlyHTTPSJSON
7
موارد قراءة موثقة
الحافلات، الخطوط، المحطات، الرحلات والموقع الحالي حسب صلاحية الخطة.
2
مستويان للتكامل
API Standard للتشغيل الأساسي وAPI Business للتكاملات الأوسع ومنها الموقع الحالي.
1
مفتاح لكل تكامل
أنشئ مفتاحًا مستقلًا لكل نظام، وحدد صلاحياته، ثم دوّره أو ألغِه عند الحاجة.
ما هي واجهة مسار للمطورين؟
واجهة رسمية تسمح لمؤسسة النقل بربط تطبيقاتها وأنظمتها الخارجية ببيانات MASAR المسموح بها، دون مشاركة حساب المالك أو بيانات دخوله.
أمثلة عملية
- تطبيق ركاب يعرض الخطوط والرحلات النشطة.
- موقع المؤسسة يعرض معلومات الحافلات والخطوط.
- نظام داخلي يقرأ حالة الرحلات لتقارير التشغيل.
- تطبيق أعمال يقرأ آخر موقع معروف للحافلة ضمن API Business.
حدود الإصدار v1
- قراءة فقط؛ لا توجد عمليات إنشاء أو تعديل أو حذف.
- لا تعرض بيانات تسجيل الدخول أو البيانات المالية أو معلومات العاملين.
- لا توجد Webhooks في الإصدار الأول.
- المفتاح يحدد المؤسسة والصلاحيات تلقائيًا.
المسار الأسرع
فعّل الميزة في اشتراك المؤسسة
يجب أن تتضمن خطة المؤسسة API Standard أو API Business.
أنشئ مفتاح تكامل
من حساب المالك ← واجهة المطورين. اختر اسم التكامل والصلاحيات ومدة الصلاحية.
اختبر حالة التكامل
curl -s "https://api.masardz.com/api/v1/partner/status" \
-H "Authorization: Bearer mapi_REPLACE_WITH_YOUR_KEY"ابدأ بموارد القراءة
ابدأ بـ /buses أو /routes، ثم أضف الموارد الأخرى حسب الحاجة.
قاعدة أمان أساسية: لا تضع مفتاح MASAR داخل تطبيق موبايل منشور أو JavaScript يعمل في المتصفح. استخدم خادمًا موثوقًا تابعًا لمؤسستك وسيطًا بين التطبيق وMASAR.