تدوير مفتاح رمز التضمين

POST/v1/projects/{id}/security-settings/rotate-embed-key

تدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.

يستبدل مفتاح رمز التضمين فورًا؛ تتوقف الرموز الموقعة بالمفتاح القديم عن العمل، ويجب إعادة توقيع روابط التضمين بالمفتاح الخام الجديد المعاد.

حد المعدّل: 10 طلبًا لكل 60 ثانية لكل جلسة.

رموز الخطأ: unauthorized (401), not_found (404), embed_tokens_unconfigured (503).

المصادقة

sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معامل projectId عند استخدام الجلسة.

الاسم	الموضع	النوع	إلزامي	الوصف
`id`	path	string (Ulid)	نعم	—

لا تأخذ هذه العملية جسم طلب.

الرمز	المعنى
`200`	مفتاح رمز التضمين الخام الجديد.
`401`	لم تُقدَّم بيانات اعتماد صالحة.
`404`	المورد غير موجود أو غير مرئي لهذا المستدعي.
`429`	تم تجاوز حد المعدّل.
`503`	التحقق من رمز التضمين غير مضبوط في هذه الواجهة.