انتقل إلى المحتوى
الشبكة تعمل بصورة طبيعية
واجهة APIالدعم+966 11 520 9090
مَساركل خطوة مرئية
طلب استلاماحسب السعر

MASAR API / VERSION 1

واجهة قصيرة.
سياق كامل.

احسب، أنشئ، واقرأ الرحلة باستخدام JSON واضح ومفاتيح وصول منفصلة لكل تكامل.

ابدأ سريعًا BASE URL https://masar.elnajmaa.com/api/v1/shipping
01 / AUTHENTICATION

مفتاح في كل طلب كتابة

أرسل المفتاح في الترويسة التالية، وخزنه في الخادم لا في JavaScript داخل المتصفح.

X-Masar-Key: your_secret_key
02 / PUBLIC TRACKING

اقرأ الرحلة دون بيانات شخصية

GET/api/v1/shipping/track/{tracking}
curl "https://masar.elnajmaa.com/api/v1/shipping/track/MSR26096100000"

تعيد الاستجابة الخدمة والحالة والمدن والأحداث العامة فقط؛ لا أسماء ولا هواتف ولا عناوين.

03 / QUOTES

احسب الوزن المحاسبي والإجمالي

POST/api/v1/shipping/quotes
{
  "origin_city": "الرياض",
  "destination_city": "جدة",
  "actual_weight": 2.5,
  "length_cm": 35,
  "width_cm": 25,
  "height_cm": 20
}
04 / SHIPMENTS

حوّل العرض إلى بوليصة

POST/api/v1/shipping/shipments

استخدم مرجع عرض صالحًا، ثم أرسل بيانات الطرفين ووصف المحتوى. تعود البوليصة برقم تتبع ورابط خاص لا يعاد عرضه لاحقًا.

05 / WEBHOOKS

دع الحالة تصل إليك

تدعم منصة الأتمتة المدمجة أحداث shipment.picked_up وshipment.in_transit وshipment.exception وshipment.delivered. تتحقق من التوقيع قبل معالجة الحمولة.

06 / ERRORS

أخطاء يمكن التعامل معها

401المفتاح مفقود أو غير صحيح
404المرجع لا يخص هذه النسخة
422فشل التحقق وتعود الأخطاء حسب الحقل
429تجاوز حد الطلبات؛ أعد المحاولة تدريجيًا