المصادقة

احصل على مفتاح API من لوحة التاجر: لوحة التاجر ← التكاملات ← توليد مفتاح API. المفتاح يظهر مرة واحدة فقط وقت التوليد — احفظه فورًا. أرسله في كل طلب داخل ترويسة Authorization.

Authorization: Bearer YOUR_API_TOKEN
Accept: application/json
Content-Type: application/json

إنشاء شحنة

بينشئ شحنة جديدة مرتبطة بحسابك، ويرجّع رقم التتبع فورًا.

{
  "receiver_name": "أحمد محمد",
  "receiver_phone": "0501234567",
  "receiver_emirate_id": 1,
  "receiver_address": "شارع الشيخ زايد",
  "payment_type": "cod",
  "cod_amount": 150,
  "external_order_id": "ORDER-1042"
}

{
  "data": {
    "tracking_number": "UAE-2026-000481",
    "status": "pending",
    "status_label": "تم إنشاء الطلب",
    "cod_amount": 150,
    "delivery_fee": 20
  }
}

curl -X POST https://gasoordel.com/api/v1/shipments \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"receiver_name":"أحمد محمد","receiver_phone":"0501234567","receiver_emirate_id":1,"receiver_address":"شارع الشيخ زايد","payment_type":"cod","cod_amount":150}'

قائمة الشحنات

بترجّع شحنات حسابك، 20 شحنة في الصفحة، الأحدث أولًا.

curl https://gasoordel.com/api/v1/shipments \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

تفاصيل شحنة

جلب شحنة واحدة برقم التتبع الخاص بيها.

curl https://gasoordel.com/api/v1/shipments/UAE-2026-000481 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

منع التكرار

لو بعتّ external_order_id وبعتّ نفس الطلب تاني بالغلط (انقطاع شبكة، إعادة محاولة تلقائية من نظامك)، السيرفر مش هينشئ شحنة جديدة — هيرجّعلك نفس الشحنة اللي اتعملت أول مرة بنفس رقم التتبع.

الأخطاء

أكواد الحالة اللي ممكن تستقبلها والمعنى بتاع كل واحد.

رموز الإمارات

استخدم الرقم في حقل receiver_emirate_id.

حالات الشحنة

القيمة اللي بترجع في حقل status، بالترتيب اللي بتتحرك بيه الشحنة عادةً.

ملاحظة: وصف الحالة (status_label) بيرجع بالعربي دايمًا من الـ API بغض النظر عن لغة الموقع.