MASAR DevelopersPARTNER API v1
MASAR DEVELOPER PLATFORM

Android و Flutter و React Native

ربط تطبيقات الموبايل بطريقة تحمي مفتاح المؤسسة: التطبيق يتصل بخادم المؤسسة، والخادم يتصل بـMASAR.

v1.0Read-onlyHTTPSJSON

النمط الموصى به للموبايل

لا تضع مفتاح Partner API داخل APK/AAB أو IPA. يمكن استخراج القيم المضمنة من التطبيق حتى لو تم تشويش الكود.
Android / Flutter / React Native
          ↓
   API خاصة بمؤسستك
          ↓
   MASAR Partner API

Android — Kotlin

هذا المثال يتصل بخادم مؤسستك، وليس مباشرة بـMASAR:

val request = Request.Builder()
    .url("https://your-company.example/api/fleet/buses")
    .get()
    .build()

OkHttpClient().newCall(request).enqueue(object : Callback {
    override fun onFailure(call: Call, e: IOException) { /* show retry */ }
    override fun onResponse(call: Call, response: Response) {
        response.use { if (!it.isSuccessful) error("HTTP ${it.code}")
            val json = it.body?.string().orEmpty()
        }
    }
})

Flutter / Dart

final response = await http.get(
  Uri.parse('https://your-company.example/api/fleet/buses'),
  headers: {'Accept': 'application/json'},
);
if (response.statusCode != 200) {
  throw Exception('تعذر تحميل البيانات');
}
final data = jsonDecode(response.body);

React Native / TypeScript

const r = await fetch('https://your-company.example/api/fleet/buses');
if (!r.ok) throw new Error(`HTTP ${r.status}`);
const data = await r.json();

الخادم الوسيط

يمكن بناء الخادم الوسيط بأي مثال Server-to-Server في صفحة تطبيقات الويب والخوادم.