Playback API v1

JSON:API-совместимые эндпоинты для управления сессиями воспроизведения, long-poll событиями плеера и метриками QoE.

Health

GET /api/v1/health — проверка доступности сервиса и версии API.

Sessions

GET /api/v1/playback/sessions — список активных playback-сессий (требуется Bearer token).

GET /api/v1/playback/sessions/{id}/poll — long-poll событий буфера, битрейта и состояния плеера.

Заголовки

• Accept: application/vnd.api+json
• Authorization: Bearer <token>
• X-Playback-Token — токен сессии воспроизведения
• Cookie: media_sid=... — идентификатор медиа-сессии

Пример ответа poll

События приходят пакетами: buffer.underrun, quality.change, heartbeat.