عرض الفيديوهات
عرض الفيديوهات
/v1/videosتدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.
تقسيم بمؤشر مفتاحي مرتب تنازليًا حسب id مع مرشحات state وq وtag. يبحث q حرفيًا ومن دون حساسية لحالة الأحرف داخل title وoriginalFilename، فلا تعمل % و_ كرموز نمط، ويطابق tag وسمًا كاملًا. يحتاج المفتاح إلى read أو جلسة مع projectId.
حد المعدّل: 120 طلبًا لكل 60 ثانية لكل مستدعٍ.
رموز الخطأ: unauthorized (401), insufficient_scope (403),
account_not_approved (403), invalid_project_id (400),
not_found (404), invalid_query (400).
المصادقة
- apiKey — مفتاح المشروع في ترويسة
Authorization: Bearerبصيغةvh_live_...للوضع الفعلي أوvh_test_...للوضع التجريبي، ويحمل صلاحيةreadو/أوwrite. - sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه
POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معاملprojectIdعند استخدام الجلسة.
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
projectId | query | string (Ulid) | لا | إلزامي عند المصادقة بملف ارتباط الجلسة، ويُتجاهل مع مفتاح الواجهة لأنه مرتبط بالمشروع أصلًا. |
limit | query | integer | لا | — |
cursor | query | string (Ulid) | لا | معرّف ULID لآخر عنصر في الصفحة السابقة. |
state | query | string (VideoState) | لا | — |
q | query | string | لا | بحث حرفي جزئي غير حساس لحالة الأحرف في title وoriginalFilename. |
tag | query | string | لا | يعيد الفيديوهات التي تحمل هذا الوسم تمامًا فقط. |
جسم الطلب
لا تأخذ هذه العملية جسم طلب.
الاستجابات
| الرمز | المعنى |
|---|---|
200 | صفحة واحدة من الفيديوهات. |
400 | فشل التحقق من جسم الطلب أو معاملاته. يذكر وصف العملية قيم error.code الدقيقة. |
401 | لم تُقدَّم بيانات اعتماد صالحة. |
403 | بيانات الاعتماد صالحة لكنها لا تسمح بهذا الإجراء. يذكر وصف العملية قيم error.code الدقيقة. |
404 | المورد غير موجود أو غير مرئي لهذا المستدعي. |
429 | تم تجاوز حد المعدّل. |
جرّبها
/v1/videosمنصة API التفاعلية
أرسل طلبًا حيًا إلى api.videohati.com بمفتاح وضع الاختبار.
يُحفظ المفتاح في متصفحك على docs.videohati.com فقط.
إلزامي عند المصادقة بملف ارتباط الجلسة، ويُتجاهل مع مفتاح الواجهة لأنه مرتبط بالمشروع أصلًا.
معرّف ULID لآخر عنصر في الصفحة السابقة.
بحث حرفي جزئي غير حساس لحالة الأحرف في `title` و`originalFilename`.
يعيد الفيديوهات التي تحمل هذا الوسم تمامًا فقط.
https://api.staging.videohati.com/v1/videos