تعيين صورة العلامة المائية للترميز
تعيين صورة العلامة المائية للترميز
PUT
/v1/projects/{id}/encoding-settings/watermark-imageتدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.
يرفع بايتات PNG أو WebP خامًا بحجم أقصى 5 MB، ويجب أن تطابق ترويسة Content-Type الصيغة الفعلية. يخزّن الصورة، ويضبط watermark.imageKey وwatermark.enabled=true، ويحذف الصورة السابقة، ثم يعيد العلامة وupdatedAt.
حد المعدّل: 20 طلبًا لكل 60 ثانية لكل جلسة.
رموز الخطأ: unauthorized (401), not_found (404), invalid_body
(400 — empty body), invalid_image (400 — the bytes are not PNG/WebP
or do not match the declared Content-Type).
المصادقة
- sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه
POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معاملprojectIdعند استخدام الجلسة.
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
id | path | string (Ulid) | نعم | — |
جسم الطلب
إلزامي
نوع المحتوى: image/png
نوع المحتوى: image/webp
الاستجابات
| الرمز | المعنى |
|---|---|
200 | كائن العلامة المائية بعد الرفع. |
400 | فشل التحقق من جسم الطلب أو معاملاته. يذكر وصف العملية قيم error.code الدقيقة. |
401 | لم تُقدَّم بيانات اعتماد صالحة. |
404 | المورد غير موجود أو غير مرئي لهذا المستدعي. |
429 | تم تجاوز حد المعدّل. |