تحديث إعدادات الترميز

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

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

تحديث جزئي؛ يُحدَّث watermark لكل مفتاح وتُرتَّب enabledResolutions تصاعديًا مع إزالة التكرار. يجب أن تكون outputCodecs مساوية تمامًا لـ ["h264"]، ويُدار watermark.imageKey عبر مسار رفع الصورة فقط. تعيد الاستجابة الكائن الفعلي مع updatedAt.

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

رموز الخطأ: unauthorized (401), not_found (404), invalid_encoding_settings (400), codec_unavailable (400 — a requested codec other than h264).

المصادقة

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

المعاملات

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

جسم الطلب

إلزامي

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

المخطّط: EncodingSettingsPatch

{
  "enabledResolutions": [
    "360p",
    "720p",
    "1080p"
  ],
  "mp4FallbackEnabled": true,
  "watermark": {
    "enabled": true,
    "position": "bottom-right",
    "opacity": 0.6
  }
}

الاستجابات

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

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

{
  "enabledResolutions": [
    "360p",
    "720p",
    "1080p"
  ],
  "mp4FallbackEnabled": true,
  "watermark": {
    "enabled": true,
    "position": "bottom-right",
    "opacity": 0.6
  }
}