إنهاء جلسة تشغيل
إنهاء جلسة تشغيل
POST
/v1/playback/sessions/{sid}/endيضبط سبب النهاية على client_end. العملية آمنة للتكرار؛ تعيد 204 حتى إذا كانت الجلسة منتهية أو غير معروفة. وعند نفاد وقت الإغلاق في المقدّمة يكتمل الإغلاق في الخلفية ويعيد الطلب الرمز 503 session_close_retryable، ويعيد تكرار الإنهاء نفسه 204 بمجرد أن يصبح الإغلاق دائمًا. وتستخدم ترويسة videohati-session-token.
رموز الخطأ: session_close_retryable (503).
المصادقة
- playbackSessionToken — رمز ملكية جلسة التشغيل في ترويسة
videohati-session-token، وتعيده عملية إنشاء الجلسة.
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
sid | path | string (Ulid) | نعم | معرّف جلسة التشغيل. |
جسم الطلب
لا تأخذ هذه العملية جسم طلب.
الاستجابات
| الرمز | المعنى |
|---|---|
204 | انتهت الجلسة أو كانت منتهية بالفعل. |
503 | عملية إغلاق الجلسة تكتمل في الخلفية؛ أعد الطلب بعد مدة Retry-After. تكرار الطلب آمن ويعيد 204 بمجرد أن يصبح الإغلاق دائمًا. |