تحديث نقطة Webhook
POST/organization/webhooks/{webhook_id}/update
يغيّر رابط نقطة النهاية وأنواع أحداثها ومرشّحاتها ووصفها؛ أرسل ما يتغير فقط. يبقى السجل وسر التوقيع، ويبقى موضع كل نوع حدث يظل مشتركًا كما هو. نوع الحدث الذي تضيفه يبدأ من الآن ولا يعيد تشغيل القوائم السابقة للتغيير. إزالة نوع تُسقط موضعه، فإعادة إضافته تبدأ من الآن أيضًا. تنطبق المرشّحات الجديدة على الأحداث التي لم توضع بعد في الطابور. لا يعيد تفعيل نقطة معطّلة: استخدم نداء التفعيل.
- المصادقة
- أرسل مفتاح إدارة (dk_admin_…) بصيغة Bearer. مفاتيح البيانات مرفوضة هنا.
- النطاق
organization- التكلفة
- مجاني
المعاملات
| الاسم | الوصف |
|---|---|
webhook_idمطلوبالنوع: string · المسار | |
Idempotency-Keyالنوع: string · الترويسة | سلسلة فريدة، ويفضل UUID، تجعل الطلب آمنًا عند التكرار. المفتاح والجسم نفسيهما يعيدان الاستجابة الأولى مع |
جسم الطلب
| الاسم | الوصف |
|---|---|
urlالنوع: string | |
event_typesالنوع: string[] | إحدى القيم: |
filtersالنوع: object | الإعلانات المطلوبة لنقطة النهاية بمفردات GET /listings. تطابق فلاتر القطعة ( |
descriptionالنوع: string | null | تؤدي القيمة null إلى المسح. |
الاستجابة
الحقل data كائن بهذه الحقول.
| الاسم | الوصف |
|---|---|
idمطلوبالنوع: string | |
urlمطلوبالنوع: string | |
event_typesمطلوبالنوع: string[] | |
filtersمطلوبالنوع: object | |
descriptionمطلوبالنوع: string | null | |
statusمطلوبالنوع: string | إحدى القيم: |
disabled_reasonمطلوبالنوع: string | null |
|
consecutive_failuresمطلوبالنوع: integer | |
created_atمطلوبالنوع: string (date-time) | وقت بصيغة ISO 8601 |
نقاط نهاية ذات صلة
- جلب مؤسستك
GET /organization - قائمة مفاتيح البيانات
GET /organization/keys - إنشاء مفتاح بيانات
POST /organization/keys - إلغاء مفتاح
POST /organization/keys/{key_id}/revoke - قائمة مشاريع المؤسسة
GET /organization/projects - الاستخدام اليومي
GET /organization/usage - قائمة الأعضاء والدعوات
GET /organization/members - قائمة أحداث التدقيق
GET /organization/audit-events - قائمة سجلات الطلبات
GET /organization/request-logs - إنشاء نقطة Webhook
POST /organization/webhooks - قائمة نقاط Webhook
GET /organization/webhooks - إعادة تفعيل نقطة Webhook
POST /organization/webhooks/{webhook_id}/enable - تدوير سر توقيع Webhook
POST /organization/webhooks/{webhook_id}/rotate-secret - حذف نقطة Webhook
POST /organization/webhooks/{webhook_id}/delete - قائمة عمليات التسليم
GET /organization/webhooks/{webhook_id}/deliveries - إعادة تشغيل تسليم
POST /organization/webhooks/{webhook_id}/deliveries/{delivery_id}/replay