API عمومية ادمج DZ Relay،
ادمج DZ Relay،
في ساعة واحدة.
ادمج الإرسال عبر نقاط الاستلام في متجرك أو نظام ERP أو ملحق التجارة الإلكترونية — دقائق لأول استدعاء، وساعات لتدفّق كامل من البداية إلى النهاية.
البدء في 3 خطوات
- أنشئ حسابك واحصل على الوصول إلى لوحة DZ Relay (انظر كن تاجرًا).
- أنشئ مفتاح API في اللوحة ضمن الإعدادات → مفاتيح API. المفتاح بصيغة
dzlk_…ويُعرَض مرة واحدة فقط. - قم بأول استدعاء للتحقّق من تكاملك:
يُعيد إليك الخادم معرّف مؤسستك ويؤكّد أن مفتاحك صالح.curl -H "Authorization: ApiKey dzlk_..." \ /api/partner/v1/health
إنشاء طرد
curl -X POST \
-H "Authorization: ApiKey dzlk_..." \
-H "Content-Type: application/json" \
-d '{
"recipientName": "Hocine Benali",
"recipientPhone": "0555 12 34 56",
"weightG": 1500,
"destinationRelayCode": "DZ-ALG-001"
}' \
/api/partner/v1/parcelsWebhooks
لتلقّي تغييرات الحالة عبر الدفع، اضبط عنوان URL + سرّ HMAC في الإعدادات → Webhooks. كل إشعار هو طلب POST موقّع بـ HMAC-SHA256 — تحقّق من التوقيع عبر الترويسة X-Dzrelay-Signature قبل معالجة الحمولة.
المرجع الكامل
وثائق تفاعلية مولّدة من مواصفات OpenAPI 3 للخادم. يمكنك أيضًا الحصول على JSON الخام: /v3/api-docs/partner (قابل للاستخدام مع OpenAPI Generator لإنشاء SDK بلغة Java / PHP / Go / TypeScript).
