PATCH/v1/webhooks/:id

تحديث Webhook

يحدّث رابط Webhook أو الأحداث المشترك فيها أو حالة التفعيل.

الصلاحية المطلوبة: webhooks.manageحد الطلبات: 10 rps

المعطيات

idstringمطلوب

معرّف الـ Webhook.

urlstringاختياري

رابط تسليم https جديد.

eventsstring[]اختياري

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

activebooleanاختياري

اضبطه على false لإيقاف عمليات التسليم مؤقتاً دون حذف الـ Webhook.

أمثلة الكود

curl -X PATCH "https://samaprime.com/api/v1/webhooks/smsord_01J8X9AABBCCDD" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://merchant.example/callbacks/salamcash","events":["order.completed"],"active":true}'

الاستجابة

→ 200
{
  "data": {
    "id": "cm_wh_01J8Z9A1BBCCDD",
    "url": "https://merchant.example/webhooks/samaprime",
    "events": [
      "order.completed",
      "order.failed"
    ],
    "active": true
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-08-06T12:00:00Z"
  }
}

الأخطاء

الحالة	الرمز
404	`not_found` لا يوجد Webhook بهذا المعرّف يخص هذا المستخدم.
400	`validation_failed` فشل النص في التحقق.
400	`invalid_event_type` نوع حدث أو أكثر غير معروف — انظر مرجع الأحداث.