MASAR API / VERSION 1
واجهة قصيرة.
سياق كامل.
احسب، أنشئ، واقرأ الرحلة باستخدام JSON واضح ومفاتيح وصول منفصلة لكل تكامل.
ابدأ سريعًا ↓BASE URL https://masar.elnajmaa.com/api/v1/shipping
مفتاح في كل طلب كتابة
أرسل المفتاح في الترويسة التالية، وخزنه في الخادم لا في JavaScript داخل المتصفح.
X-Masar-Key: your_secret_keyاقرأ الرحلة دون بيانات شخصية
GET
/api/v1/shipping/track/{tracking}curl "https://masar.elnajmaa.com/api/v1/shipping/track/MSR26096100000"تعيد الاستجابة الخدمة والحالة والمدن والأحداث العامة فقط؛ لا أسماء ولا هواتف ولا عناوين.
احسب الوزن المحاسبي والإجمالي
POST
/api/v1/shipping/quotes{
"origin_city": "الرياض",
"destination_city": "جدة",
"actual_weight": 2.5,
"length_cm": 35,
"width_cm": 25,
"height_cm": 20
}حوّل العرض إلى بوليصة
POST
/api/v1/shipping/shipmentsاستخدم مرجع عرض صالحًا، ثم أرسل بيانات الطرفين ووصف المحتوى. تعود البوليصة برقم تتبع ورابط خاص لا يعاد عرضه لاحقًا.
دع الحالة تصل إليك
تدعم منصة الأتمتة المدمجة أحداث shipment.picked_up وshipment.in_transit وshipment.exception وshipment.delivered. تتحقق من التوقيع قبل معالجة الحمولة.
أخطاء يمكن التعامل معها
401المفتاح مفقود أو غير صحيح
404المرجع لا يخص هذه النسخة
422فشل التحقق وتعود الأخطاء حسب الحقل
429تجاوز حد الطلبات؛ أعد المحاولة تدريجيًا