فيديوهاتيالتوثيق

تحديث بيانات الفيديو أو ظهوره

تحديث بيانات الفيديو أو ظهوره

PATCH/v1/videos/{id}

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

تحديث جزئي يتطلب حقلًا واحدًا على الأقل من title وdescription وtags وvisibility. لا يتغيّر originalFilename؛ ويمسح null أو النص الفارغ الوصف، وتستبدل الوسوم القائمة كاملة مع إزالة التكرار وبحد 20 وسمًا. يتيح unlisted وpublic المشاهدة المجهولة، ويجعل public الصفحة قابلة للفهرسة وحده. يحتاج المفتاح إلى write.

رموز الخطأ: unauthorized (401), insufficient_scope (403), account_not_approved (403), invalid_project_id (400), not_found (404), video_not_found (404), invalid_body (400).

المصادقة

  • apiKey — مفتاح المشروع في ترويسة Authorization: Bearer بصيغة vh_live_... للوضع الفعلي أو vh_test_... للوضع التجريبي، ويحمل صلاحية read و/أو write.
  • sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معامل projectId عند استخدام الجلسة.

المعاملات

الاسمالموضعالنوعإلزاميالوصف
idpathstring (Ulid)نعم—
projectIdquerystring (Ulid)لاإلزامي عند المصادقة بملف ارتباط الجلسة، ويُتجاهل مع مفتاح الواجهة لأنه مرتبط بالمشروع أصلًا.

جسم الطلب

إلزامي

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

المخطّط: VideoUpdateRequest

{
  "title": "Launch keynote",
  "tags": [
    "keynote",
    "arabic"
  ],
  "visibility": "unlisted"
}

الاستجابات

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

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

{
  "title": "Launch keynote",
  "tags": [
    "keynote",
    "arabic"
  ],
  "visibility": "unlisted"
}

جرّبها

PATCH
/v1/videos/{id}
وضع الاختبار فقط

منصة API التفاعلية

أرسل طلبًا حيًا إلى api.videohati.com بمفتاح وضع الاختبار.

تحجب هذه المنصة مفاتيح vh_live_. استخدم مفتاحًا يبدأ بـ vh_test_ فقط؛ لن يغادر أي طلب بمفتاح حي متصفحك.

يُحفظ المفتاح في متصفحك على docs.videohati.com فقط.

إلزامي عند المصادقة بملف ارتباط الجلسة، ويُتجاهل مع مفتاح الواجهة لأنه مرتبط بالمشروع أصلًا.

https://api.staging.videohati.com/v1/videos/{id}

في هذه الصفحة

المصادقةالمعاملاتجسم الطلبالاستجاباتمثال على الطلبجرّبها