الإدارة

تدوير سر توقيع الـ webhook

يتطلب رمز إدارة (Management Token) لمساحة العمل (mt-...)، يتم إنشاؤه من Dashboard > API > Management Tokens. أرسل Authorization: Bearer mt-.... لا يتم قبول مفاتيح Inference API (sk-...) وأسرار توقيع خطاف الويب (whsec_...). يمكن الوصول فقط إلى مساحة عمل الـ token. يتم إرجاع سر التوقيع الكامل whsec_ فقط عند الإنشاء أو التدوير. قم بتخزينه بشكل آمن؛ لا تقوم عمليات GET/list بإرجاعه أبداً. يسري التدوير فوراً على عمليات التسليم الجديدة؛ أما عمليات التسليم الجارية بالفعل فيمكنها الاستمرار في استخدام السر السابق.

POSThttps://api.tokenlab.sh/v1/management/webhooks/{webhookId}/rotate-secret

استخدم Management Token (mt-...) الخاص بمساحة العمل، وليس مفتاح API للاستنتاج (sk-...) أو سر التوقيع (whsec_...). قم بإنشاء واحد من خلال لوحة التحكم ← API ← Management Tokens وأرسل Authorization: Bearer mt-.... الوصول مقيد بمساحة العمل تلك.

راجع دليل إدارة الـ Webhook API للاطلاع على الأحداث، والتحقق، وإعادة المحاولة، واستكشاف الأخطاء وإصلاحها.

curl -X POST "https://example.com/v1/management/webhooks/string/rotate-secret"
{  "id": "string",  "object": "webhook_endpoint",  "url": "string",  "events": [    "task.completed"  ],  "is_active": true,  "description": "string",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "last_delivered_at": "2019-08-24T14:15:22Z",  "failure_count": 0,  "secret": "string"}

التفويض

ManagementTokenAuth
AuthorizationBearer <token>

مصادقة رمز الإدارة (Management token). قم بإنشاء أو إدارة رموز الإدارة في Dashboard > API > Management Tokens.

الموضع: header

معاملات المسار

webhookId*string
الطول1 <= length <= 128

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json