توثيق الويب هوكس

تتيح لك ويب هوكس وينجز استلام إشعارات HTTP فورية عند وقوع أحداث الأوردرات في حسابك. سجّل رابطاً لكل نوع حدث؛ نرسل طلباً موقّعاً ببيانات الأوردر.

1. أضف رابط webhook واختر الإجراء (مثل order-create).
2. انسخ مفتاح التوقيع المعروض مرة واحدة — واحفظه بأمان على سيرفرك.
3. عند وقوع الحدث، يرسل وينجز بيانات JSON إلى رابطك مع رؤوس HMAC.
4. تحقق من التوقيع، ثم عالج بيانات الأوردر.
5. أرجع استجابة HTTP 2xx بسرعة؛ واستخدم سجل الويب هوك لتتبع التسليم.

ترويسات الطلب

احسب HMAC-SHA256 لجسم الطلب باستخدام سر التوقيع ثم شفّره بـ Base64. قارنه برأس X-Wingezz-Hmac-Sha256 بمقارنة آمنة زمنياً.

// PHP example
$secret = 'your_webhook_signing_secret';
$rawBody = file_get_contents('php://input');
$expected = base64_encode(hash_hmac('sha256', $rawBody, $secret, true));
$provided = $_SERVER['HTTP_X_WINGEZZ_HMAC_SHA256'] ?? '';
if (!hash_equals($expected, $provided)) {
 http_response_code(401);
 exit('Invalid signature');
}

إذا لم تضبط تعيين محتوى مخصص، سيتم إرسال البيانات الافتراضية كاملة:

{
 "event": "order-create",
 "sent_at": "2026-09-02T10:30:00+03:00",
 "order": {
 "id": 12345,
 "serial_no": "WNG-12345",
 "reference_no": "REF-001",
 "type": "Delivery",
 "status": "جديد",
 "status_en": "New",
 "customer_name": "Ahmed",
 "customer_phone": "201012345678",
 "govern": "Cairo",
 "area": "Nasr City",
 "cost": 150,
 "deliver_cost": 30,
 "source": "api",
 "created_at": "2026-09-02T10:00:00+03:00"
 }
}

يمكنك تعريف مفاتيح JSON خاصة وربطها بحقول الأوردر. تُحوَّل المفاتيح الخارجية إلى قيم مقروءة (اسم الحالة بدل معرّفها، واسم المحافظة بدل govern_id، إلخ). لا تُعرض المعرّفات الداخلية أو الحقول الحساسة أبداً.

يمكنك أيضاً إضافة رؤوس HTTP مخصصة (مثل Authorization أو X-Api-Key) من صفحة إعدادات الويب هوك. رؤوس توقيع وينجز تُضبط تلقائياً ولا يمكن تجاوزها.

أدر الويب هوكس من لوحة وينجز تحت الويب هوكس، أو من إعدادات ملف التاجر.