Webhooks

تدفع الـ Webhooks إشعارات فورية إلى خادمك عند حدوث أحداث في متجرك.

أنواع الأحداث

الحدث	المحفّز
order.created	طلب جديد
order.status_changed	تحديث حالة الطلب
product.created	إضافة منتج جديد
product.updated	تغيير تفاصيل المنتج
customer.created	تسجيل عميل جديد
inventory.changed	تغيير مستوى المخزون

صيغة الحمولة

{
  "id": "delivery-uuid",
  "event": "order.created",
  "entity_type": "order",
  "entity_id": "order-uuid-123",
  "data": { "id": "order-uuid-123", "status": "pending", "total": 80.00 },
  "timestamp": "2026-04-20T14:30:00Z"
}

الرؤوس

الرأس	الوصف
X-Tajir-Signature	توقيع HMAC-SHA256
X-Tajir-Event	نوع الحدث
X-Tajir-Delivery	معرف التسليم

التحقق من التوقيع (Python)

import hmac, hashlib

def verify_signature(payload: bytes, secret: str, signature: str) -> bool:
    expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)

سياسة إعادة المحاولة

المحاولة	التأخير
الأولى	1 دقيقة
الثانية	5 دقائق
الثالثة	30 دقيقة
الرابعة	ساعتان
الخامسة	12 ساعة

بعد 5 محاولات فاشلة، يُنقل إلى قائمة الرسائل الميتة (DLQ).