الـ Webhooks
استقبال اشعارات فورية عن الاحداث في متجرك عبر Webhooks
الـ Webhooks تتيح لتطبيقاتك الخارجية استقبال اشعارات فورية عند حدوث احداث معينة في المتجر.
كيف تعمل
- تسجّل عنوان URL في اعدادات المتجر
- عند حدوث حدث (مثل طلب جديد)، مُلكم ترسل طلب POST
- تطبيقك يستقبل البيانات ويعالجها
تسجيل Webhook
POST /functions/v1/webhooks/register
الاحداث المتاحة
احداث الطلبات
| الحدث | متى يُطلق |
|---|---|
order.created | طلب جديد |
order.updated | تحديث حالة الطلب |
order.paid | تم الدفع |
order.shipped | تم الشحن |
order.delivered | تم التوصيل |
order.cancelled | تم الالغاء |
order.refunded | تم الاسترداد |
احداث المنتجات
| الحدث | متى يُطلق |
|---|---|
product.created | منتج جديد |
product.updated | تحديث منتج |
product.deleted | حذف منتج |
inventory.updated | تغيير المخزون |
احداث العملاء
| الحدث | متى يُطلق |
|---|---|
customer.created | عميل جديد |
customer.updated | تحديث بيانات عميل |
شكل البيانات (Payload)
التحقق من التوقيع
كل طلب Webhook يحتوي هيدر X-Mollkom-Signature للتحقق من الاصالة:
اعادة المحاولة
اذا لم يستجب عنوانك بـ 200 OK خلال 10 ثوانٍ:
- محاولة 1: فورية
- محاولة 2: بعد 1 دقيقة
- محاولة 3: بعد 5 دقائق
- محاولة 4: بعد 30 دقيقة
- محاولة 5: بعد ساعة
بعد 5 محاولات فاشلة، يتم تعطيل الـ Webhook وارسال اشعار للتاجر.