تحديث إعدادات حماية البث

PATCH/v1/projects/{id}/security-settings

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

تحديث جزئي يطبّع أنماط النطاقات إلى أحرف صغيرة، ويزيل المخطط والمسار، ويزيل التكرار؛ ويطابق *.example.com النطاق الأصلي وكل نطاقاته الفرعية. يُعاد الكائن الفعلي كاملًا، ويؤدي تفعيل embedTokenAuthEnabled إلى إنشاء المفتاح عند غيابه.

رموز الخطأ: unauthorized (401), not_found (404), invalid_security_settings (400), embed_tokens_unconfigured (503 — the API has no EMBED_TOKEN_KEY_MASTER).

المصادقة

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

المعاملات

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

جسم الطلب

إلزامي

نوع المحتوى: application/json

المخطّط: StreamSecuritySettingsPatch

{
  "allowedReferrers": [
    "*.myschool.example"
  ],
  "blockedReferrers": [
    "pirate.example"
  ],
  "blockDirectUrlAccess": true
}

الاستجابات

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

مثال على الطلب

{
  "allowedReferrers": [
    "*.myschool.example"
  ],
  "blockedReferrers": [
    "pirate.example"
  ],
  "blockDirectUrlAccess": true
}