الإدارة
إنشاء نقطة نهاية لـ webhook
يتطلب رمز إدارة (Management Token) لمساحة العمل (mt-...)، يتم إنشاؤه من Dashboard > API > Management Tokens. أرسل Authorization: Bearer mt-.... لا يتم قبول مفاتيح Inference API (sk-...) وأسرار توقيع خطاف الويب (whsec_...). يمكن الوصول فقط إلى مساحة عمل الـ token. يتم إرجاع سر التوقيع الكامل whsec_ فقط عند الإنشاء أو التدوير. قم بتخزينه بشكل آمن؛ لا تقوم عمليات GET/list بإرجاعه أبداً. يسري التدوير فوراً على عمليات التسليم الجديدة؛ أما عمليات التسليم الجارية بالفعل فيمكنها الاستمرار في استخدام السر السابق. بحد أقصى 10 نقاط نهاية لكل مساحة عمل. تغطي الاشتراكات أحداث المهام غير المتزامنة النهائية المستقبلية؛ ولا يتم إعادة تشغيل المهام الحالية.
استخدم Management Token (mt-...) الخاص بمساحة العمل، وليس مفتاح API للاستنتاج (sk-...) أو سر التوقيع (whsec_...). قم بإنشاء واحد من خلال لوحة التحكم ← API ← Management Tokens وأرسل Authorization: Bearer mt-.... الوصول مقيد بنطاق مساحة العمل تلك.
راجع دليل إدارة Webhook API لمعرفة المزيد حول الأحداث، والتحقق، وإعادة المحاولة، واستكشاف الأخطاء وإصلاحها.
curl -X POST "https://example.com/v1/management/webhooks" \ -H "Content-Type: application/json" \ -d '{ "url": "http://example.com", "events": [ "task.completed" ] }'{ "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 مصادقة رمز الإدارة (Management token). قم بإنشاء أو إدارة رموز الإدارة في Dashboard > API > Management Tokens.
الموضع: header
جسم الطلب
application/json
الاستجابة
application/json
application/json
application/json
application/json
application/json
application/json