تدوير سر توقيع Webhook
POST/organization/webhooks/{webhook_id}/rotate-secret
يصدر سر توقيع جديدًا يظهر مرة واحدة في الاستجابة. طوال overlap_seconds (الافتراضي 86400، حتى 7 أيام؛ 0 بلا تداخل) يحمل كل تسليم توقيعًا للسر الجديد والسابق معًا، فيمكن للمستقبِل التحقق بأيٍّ منهما أثناء التداخل. يجب على المستقبِل قبول الترويسة إذا طابق أي إدخال v1: إدخال السر الجديد يأتي أولًا، فالمحلل الذي يقرأ آخر v1 فقط يحصل على توقيع السر السابق حتى ينتهي التداخل. بعد تسرّب استخدم 0. التدوير مجددًا أثناء التداخل يُسقط السر الأقدم.
- المصادقة
- أرسل مفتاح إدارة (dk_admin_…) بصيغة Bearer. مفاتيح البيانات مرفوضة هنا.
- النطاق
organization- التكلفة
- مجاني
المعاملات
| الاسم | الوصف |
|---|---|
webhook_idمطلوبالنوع: string · المسار | |
Idempotency-Keyالنوع: string · الترويسة | سلسلة فريدة، ويفضل UUID، تجعل الطلب آمنًا عند التكرار. المفتاح والجسم نفسيهما يعيدان الاستجابة الأولى مع |
جسم الطلب
| الاسم | الوصف |
|---|---|
overlap_secondsالنوع: integer | المدة التي يواصل فيها السر السابق التوقيع. الافتراضي 86400. |
الاستجابة
الحقل data كائن بهذه الحقول.
| الاسم | الوصف |
|---|---|
idمطلوبالنوع: string | |
secretمطلوبالنوع: string | سر التوقيع الجديد؛ يُعرض مرة واحدة. |
previous_secret_expires_atمطلوبالنوع: string (date-time) | null | وقت توقف السر القديم عن التوقيع؛ null إن توقف فعلًا. |
نقاط نهاية ذات صلة
- جلب مؤسستك
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}/update - إعادة تفعيل نقطة Webhook
POST /organization/webhooks/{webhook_id}/enable - حذف نقطة Webhook
POST /organization/webhooks/{webhook_id}/delete - قائمة عمليات التسليم
GET /organization/webhooks/{webhook_id}/deliveries - إعادة تشغيل تسليم
POST /organization/webhooks/{webhook_id}/deliveries/{delivery_id}/replay