تحديث إعدادات جلسات التشغيل

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

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

تحديث جزئي: أرسل الحقول المتغيّرة فقط، واضبط الحقل على null لإعادته إلى الوراثة. يُخزَّن ويُعاد الكائن الفعلي كاملًا، ويُرفض أي تحديث تصبح معه sessionTtlDefaultSeconds أكبر من sessionTtlMaxSeconds.

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

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

المصادقة

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

المعاملات

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

جسم الطلب

إلزامي

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

المخطّط: SessionSettingsPatch

{
  "concurrentStreamsPerViewer": 2,
  "evictionGraceSeconds": 120
}

الاستجابات

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

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

{
  "concurrentStreamsPerViewer": 2,
  "evictionGraceSeconds": 120
}