إنشاء جلسة تشغيل

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

استدعاء من الخادم فقط؛ لا تكشف مفتاح المشروع للمتصفح. يعيد manifestUrl موقّعًا وsource وsessionToken وwatermarkToken وبيانات التتبّع. يجب أن يملك الفيديو دقة واحدة قابلة للتشغيل على الأقل. يحتاج المفتاح إلى read أو جلسة مع projectId.

حد المعدّل: 30 طلبًا لكل 60 ثانية لكل مستدعٍ.

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

المصادقة

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

المعاملات

جسم الطلب

إلزامي

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

المخطّط: PlaybackSessionCreateRequest

{
  "videoId": "01JZ9WV3N8GQ5T2M7K4C6XBARH",
  "ttlSeconds": 3600,
  "watermarkText": "Ahmed K."
}

الاستجابات

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

{
  "videoId": "01JZ9WV3N8GQ5T2M7K4C6XBARH",
  "ttlSeconds": 3600,
  "watermarkText": "Ahmed K."
}

جرّبها