نبضة جلسة التشغيل
نبضة جلسة التشغيل
POST
/v1/playback/sessions/{sid}/heartbeatيرسلها المشغّل كل heartbeatIntervalSeconds لتعليم الجلسة بأنها حية وتدوير رمز العلامة المائية. تُرسل الملكية في videohati-session-token، وتُرفض الجلسات المنتهية أو الملغاة بسبب حد التزامن. وإذا أنهت النبضة الجلسة (ألغتها بوابة التسليم) ونفد وقت الإغلاق في المقدّمة، يكتمل الإغلاق في الخلفية وتعيد النبضة الرمز 503 session_close_retryable.
حد المعدّل: 10 طلبًا لكل 60 ثانية لكل جلسة.
رموز الخطأ: session_invalid (403), session_expired (403),
session_revoked_concurrent_cap (403), invalid_body (400),
session_close_retryable (503).
المصادقة
- playbackSessionToken — رمز ملكية جلسة التشغيل في ترويسة
videohati-session-token، وتعيده عملية إنشاء الجلسة.
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
sid | path | string (Ulid) | نعم | معرّف جلسة التشغيل. |
جسم الطلب
إلزامي
نوع المحتوى: application/json
المخطّط: HeartbeatRequest
{
"nonce": "5f1c9d2a",
"positionSeconds": 42.5
}الاستجابات
| الرمز | المعنى |
|---|---|
200 | قُبلت النبضة وصدر رمز علامة مائية جديد. |
400 | فشل التحقق من جسم الطلب أو معاملاته. يذكر وصف العملية قيم error.code الدقيقة. |
403 | بيانات الاعتماد صالحة لكنها لا تسمح بهذا الإجراء. يذكر وصف العملية قيم error.code الدقيقة. |
429 | تم تجاوز حد المعدّل. |
503 | عملية إغلاق الجلسة تكتمل في الخلفية؛ أعد الطلب بعد مدة Retry-After. تكرار الطلب آمن ويعيد 204 بمجرد أن يصبح الإغلاق دائمًا. |
مثال على الطلب
{
"nonce": "5f1c9d2a",
"positionSeconds": 42.5
}