تعيين صورة مصغّرة مخصّصة
تعيين صورة مصغّرة مخصّصة
/v1/videos/{id}/thumbnailتدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.
يستبدل الصورة المصغّرة ببايتات JPEG أو PNG أو WebP خامًا حتى 5 MB، ويجب أن تطابق Content-Type الصيغة الفعلية. تبقى الصورة المخصّصة عبر إعادة الترميز، ويعيد المسار رابطها العام. يحتاج المفتاح إلى write.
حد المعدّل: 30 طلبًا لكل 60 ثانية لكل مستدعٍ.
رموز الخطأ: unauthorized (401), insufficient_scope (403),
account_not_approved (403), invalid_project_id (400),
invalid_image (400), invalid_body (400), not_found (404),
video_not_found (404). Unsupported content types return 415;
oversize bodies return 413.
المصادقة
- apiKey — مفتاح المشروع في ترويسة
Authorization: Bearerبصيغةvh_live_...للوضع الفعلي أوvh_test_...للوضع التجريبي، ويحمل صلاحيةreadو/أوwrite. - sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه
POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معاملprojectIdعند استخدام الجلسة.
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
id | path | string (Ulid) | نعم | — |
projectId | query | string (Ulid) | لا | إلزامي عند المصادقة بملف ارتباط الجلسة، ويُتجاهل مع مفتاح الواجهة لأنه مرتبط بالمشروع أصلًا. |
جسم الطلب
إلزامي
نوع المحتوى: image/jpeg
نوع المحتوى: image/png
نوع المحتوى: image/webp
الاستجابات
| الرمز | المعنى |
|---|---|
200 | الرابط العام الجديد للصورة المصغّرة. |
400 | فشل التحقق من جسم الطلب أو معاملاته. يذكر وصف العملية قيم error.code الدقيقة. |
401 | لم تُقدَّم بيانات اعتماد صالحة. |
403 | بيانات الاعتماد صالحة لكنها لا تسمح بهذا الإجراء. يذكر وصف العملية قيم error.code الدقيقة. |
404 | المورد غير موجود أو غير مرئي لهذا المستدعي. |
429 | تم تجاوز حد المعدّل. |
جرّبها
/v1/videos/{id}/thumbnailمنصة API التفاعلية
أرسل طلبًا حيًا إلى api.videohati.com بمفتاح وضع الاختبار.
يُحفظ المفتاح في متصفحك على docs.videohati.com فقط.
إلزامي عند المصادقة بملف ارتباط الجلسة، ويُتجاهل مع مفتاح الواجهة لأنه مرتبط بالمشروع أصلًا.
https://api.staging.videohati.com/v1/videos/{id}/thumbnail