MASAR DevelopersPARTNER API v1
MASAR DEVELOPER PLATFORM

البدء السريع

من إنشاء مفتاح التكامل إلى أول طلب ناجح في دقائق، مع أقل قدر ممكن من الصلاحيات.

v1.0Read-onlyHTTPSJSON

قبل أن تبدأ

تحتاج إلى

  • حساب مالك لمؤسسة على MASAR.
  • خطة تتضمن واجهة المطورين.
  • نظام أو خادم قادر على إرسال HTTPS.
  • تخزين آمن لمفتاح التكامل.

عنوان الخدمة

https://api.masardz.com/api/v1/partner

جميع أمثلة هذه الوثائق تستخدم بيئة الإنتاج.

إنشاء أول مفتاح

افتح واجهة المطورين

سجّل الدخول كمالك ثم افتح «واجهة المطورين API».

سمِّ التكامل

استخدم اسمًا واضحًا مثل «موقع المؤسسة» أو «تطبيق الركاب» بدل أسماء عامة.

اختر أقل صلاحيات ممكنة

إذا كان التطبيق يحتاج الخطوط فقط، لا تمنحه صلاحية GPS.

انسخ المفتاح مرة واحدة

بعد الإنشاء يظهر المفتاح الكامل مرة واحدة. خزنه في مدير أسرار أو متغير بيئة على خادمك.

أول طلب

GET
/status
اختبر صلاحية المفتاح والخطة وحد الطلبات.
curl -i "https://api.masardz.com/api/v1/partner/status" \
  -H "Authorization: Bearer mapi_REPLACE_WITH_YOUR_KEY" \
  -H "Accept: application/json"

استجابة متوقعة

{
  "success": true,
  "code": "OK",
  "message": "Success",
  "data": {
    "plan": "API Standard",
    "level": "standard",
    "scopes": ["buses:read", "routes:read", "stops:read", "trips:read"],
    "rate_limit_per_minute": 60
  },
  "meta": {
    "request_id": "pa_example",
    "rate_limit": {"limit": 60, "remaining": 59, "reset_at": 1780000000}
  }
}

بعد نجاح الاختبار