اربط متجرك في ٥ دقايق.
تطبيق جاهز لمنصتك، أو REST API لو بتبني بنفسك.
API/00البداية
المصادقة والبيئات.
| Base URL | https://api.meshwar.eg/v1 |
| Sandbox | https://sandbox.meshwar.eg/v1 |
| Auth | Bearer {API_KEY} |
| الصيغة | application/json |
API/01الشحنات
إنشاء شحنة.
POST/v1/shipments
curl -X POST https://api.meshwar.eg/v1/shipments \
-H "Authorization: Bearer $MESHWAR_KEY" \
-H "Content-Type: application/json" \
-d '{
"reference": "ORD-8842",
"service": "standard",
"cod_value": 890,
"parcel": { "weight_kg": 1.4, "description": "Apparel" },
"recipient": {
"name": "Nour Hassan",
"phone": "01001234567",
"governorate": "DKH",
"address": "12 Gomhoreya St, Mansoura"
}
}'201 Createdالرد
{
"tracking_number": "MSH-100000001",
"reference": "ORD-8842",
"status": "picked-up",
"service": "standard",
"hub": "CAI-01",
"cod_value": 890,
"pricing": {
"shipping": 55.00,
"cod_fee": 10.00,
"total": 65.00,
"currency": "EGP"
},
"sla": {
"committed_days": [1, 2],
"cut_off": "19:00"
},
"label_url": "https://api.meshwar.eg/v1/labels/MSH-100000001.pdf",
"created_at": "2026-07-22T10:12:00+03:00"
}API/02Webhooks
الأحداث.
كل حدث بيتبعت مرة واحدة على الأقل، وبيعيد المحاولة ٦ مرات بتباعد متزايد لو الرد مش 2xx.
| Event | بيتبعت إمتى |
|---|---|
| shipment.created | الشحنة اتسجلت في النظام |
| shipment.picked_up | المندوب استلم من التاجر |
| shipment.at_hub | الشحنة دخلت الفرز |
| shipment.out_for_delivery | خرجت مع مندوب التسليم |
| shipment.delivered | اتسلّمت واتوقّع عليها |
| shipment.attempt_failed | محاولة تسليم فشلت |
| shipment.returned | رجعت للتاجر |
| payout.executed | تحويل الكاش‑آوت اتنفّذ |
API/03الحدود
حدود الاستخدام.
| العملية | الحد |
|---|---|
| إنشاء شحنة | 120 / min |
| استعلام تتبّع | 600 / min |
| رفع دفعة | 10 / min |
| تقارير | 30 / min |
API/04الإضافات
من غير كود خالص.
Shopify
تطبيق جاهز
الربط في 5 دقيقة
WooCommerce
إضافة WordPress
الربط في 8 دقيقة
Salla
تطبيق جاهز
الربط في 5 دقيقة
Zid
تطبيق جاهز
الربط في 5 دقيقة
Magento
موديول
الربط في 15 دقيقة
Custom
REST API
الربط في 30 دقيقة