سريع إكسبريس

التغطية

يغطي سريع إكسبريس المملكة العربية السعودية ودول مجلس التعاون الخليجي التالية:

الخدمات

نقطة النهاية — الوصول المباشر (Passthrough)

يمكن الوصول إلى سريع إكسبريس مباشرة عبر نقطة نهاية واحدة، ويحدد الحقل action نوع العملية. تستخدم المصادقة نفسها المعتمدة في منصة منفذ (مفتاح API في ترويسة Authorization).

POST /api/v1/carriers/SARIE/passthrough

حقول الطلب

مثال عملي — إنشاء شحنة خليجية

المثال التالي ينشئ شحنة إكسبريس من الرياض إلى دبي بطرد واحد وزنه 2.5 كجم. استبدل mnf_live_YOUR_KEY بمفتاح فريقك.

curl -X POST "https://manfath.example/api/v1/carriers/SARIE/passthrough" \
  -H "Authorization: Bearer mnf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "ship",
  "service": "EXP_GCC",
  "origin": {
    "country": "SA",
    "city": "Riyadh",
    "short_address": "RRDA2929"
  },
  "destination": {
    "country": "AE",
    "city": "Dubai"
  },
  "parcels": [
    { "weight_kg": 2.5, "length_cm": 30, "width_cm": 20, "height_cm": 15 }
  ],
  "declared_value": 450,
  "hs_codes": ["330499"],
  "incoterm": "DDP",
  "cod_amount": 0,
  "ship_date": "2026-07-27"
}'

الاستجابة

HTTP/1.1 201 Created
Content-Type: application/json
X-Manfath-Request-Id: req_a1b2c3d4

{
  "tracking_number": "SRE4021183740",
  "manfath_reference": "MNF-2026-8KTQ2N",
  "status": "CREATED",
  "carrier": "SARIE",
  "service": "EXP_GCC",
  "estimated_delivery_at": "2026-07-31T18:00:00+03:00",
  "label_url": "/api/v1/shipments/SRE4021183740/label"
}

رموز الأخطاء

تعيد جميع الأخطاء رمز حالة HTTP دلاليًا مع مغلف خطأ موحد يتضمن الرمز والرسالة بالعربية والإنجليزية وتفاصيل اختيارية:

{
  "error": {
    "code": "E_VALIDATION",
    "message_en": "Request validation failed.",
    "message_ar": "فشل التحقق من صحة الطلب.",
    "details": { "field": "parcels[0].weight_kg", "issue": "must be a positive number" }
  }
}