حذف فيديو حذفًا منطقيًا
حذف فيديو حذفًا منطقيًا
DELETE
/v1/videos/{id}تدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.
يضبط deleted_at ويلغي أي جلسة رفع نشطة. يحتاج مفتاح المشروع إلى write أو جلسة لوحة التحكم مع projectId، وقد يتعارض مع إكمال رفع جارٍ.
حد المعدّل: 60 طلبًا لكل 60 ثانية لكل مستدعٍ.
رموز الخطأ: unauthorized (401), insufficient_scope (403),
account_not_approved (403), invalid_project_id (400),
not_found (404), upload_completion_in_progress (409).
المصادقة
- apiKey — مفتاح المشروع في ترويسة
Authorization: Bearerبصيغةvh_live_...للوضع الفعلي أوvh_test_...للوضع التجريبي، ويحمل صلاحيةreadو/أوwrite. - sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه
POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معاملprojectIdعند استخدام الجلسة.
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
id | path | string (Ulid) | نعم | — |
projectId | query | string (Ulid) | لا | إلزامي عند المصادقة بملف ارتباط الجلسة، ويُتجاهل مع مفتاح الواجهة لأنه مرتبط بالمشروع أصلًا. |
جسم الطلب
لا تأخذ هذه العملية جسم طلب.
الاستجابات
| الرمز | المعنى |
|---|---|
204 | حُذف الفيديو حذفًا منطقيًا. |
400 | فشل التحقق من جسم الطلب أو معاملاته. يذكر وصف العملية قيم error.code الدقيقة. |
401 | لم تُقدَّم بيانات اعتماد صالحة. |
403 | بيانات الاعتماد صالحة لكنها لا تسمح بهذا الإجراء. يذكر وصف العملية قيم error.code الدقيقة. |
404 | المورد غير موجود أو غير مرئي لهذا المستدعي. |
409 | يتعارض الطلب مع الحالة الحالية للمورد. يذكر وصف العملية قيم error.code الدقيقة. |
429 | تم تجاوز حد المعدّل. |
جرّبها
DELETE
/v1/videos/{id}وضع الاختبار فقط
منصة API التفاعلية
أرسل طلبًا حيًا إلى api.videohati.com بمفتاح وضع الاختبار.
تحجب هذه المنصة مفاتيح vh_live_. استخدم مفتاحًا يبدأ بـ vh_test_ فقط؛ لن يغادر أي طلب بمفتاح حي متصفحك.
يُحفظ المفتاح في متصفحك على docs.videohati.com فقط.
إلزامي عند المصادقة بملف ارتباط الجلسة، ويُتجاهل مع مفتاح الواجهة لأنه مرتبط بالمشروع أصلًا.
https://api.staging.videohati.com/v1/videos/{id}