القسم الحالي: إعداد Webhooks

التنبيهات وWebhooks - إعداد Webhooks

سجّل عناوين استقبال إشعارات Webhook وتحقق من صلاحيتها قبل تفعيل قواعد التنبيه.

POST /api/v1/webhooks/

Pro+

أضف عنوان Webhook لاستقبال التنبيهات والإشعارات من سهمك.

مسار API

https://api.sahmk.sa/api/v1/webhooks/

المعاملات

(*) مطلوب

المعاملالنوعالقيم المقبولة
* urlstring

رابط HTTPS لاستقبال الإشعارات

namestring

اسم وصفي اختياري

  • المعامل المطلوب: url — رابط HTTPS الذي يستقبل إشعارات Webhook.
  • المعامل الاختياري: name — اسم وصفي لتسهيل التعرف على عنوان الاستقبال.
  • التحقق من العنوان: عند إنشاء Webhook، يُرسل النظام طلب تحقق (Challenge) إلى العنوان المحدد. ويجب أن يستجيب الخادم برمز HTTP 200 لاجتياز التحقق.
  • مفتاح التوقيع السري: يُعاد الحقل signing_secret عند إنشاء Webhook فقط، ولا يظهر لاحقاً عند استعراض قائمة Webhooks أو طلب تفاصيل أحدها. احرص على حفظه بشكل آمن عند الإنشاء.
200 OKapplication/json
{
  "id": 19,
  "url": "https://example.com/hooks/sahmk",
  "name": "Trading Production Hook",
  "signing_secret": "xxxxxxxxxxxxxxxx",
  "is_verified": false,
  "is_active": true,
  "created_at": "2026-05-08T13:30:12+03:00"
}

الخطوة التالية: راجع قسمَي «التحقق من التوقيع» و«مراحل إرسال الإشعارات» لاستكمال إعداد Webhook للاستخدام الفعلي.

آخر تحديث في