Управление эпизодами¶

media.episodes.management

Эпизод связывает событие со стримом и временем видео. media.episodes.management отвечает за управление, хранение и доступ к эпизодам; это позиция существующей тарифной сетки для стрима.

Central хранит последнее состояние эпизода и его изображения в PostgreSQL. Харвестер получает обновления со стримеров; management API читает сохранённую историю, поэтому доступность исходного стримера не требуется. Исходные данные payload и дополнительные данные внешних систем meta хранятся отдельно.

Чтение¶

GET /central/api-v4/episodes возвращает общую выборку, а GET /central/api-v4/episodes/{episode_id} — один эпизод. Можно совместить фильтры стрима, типа и времени с JSON-фильтром meta. Листание идёт по next_cursor; limit по умолчанию 100, максимум 1000. Offset запрещён.

Зрительский доступ использует /playback/v/{stream_name}/episodes на central и /streaming/v/{stream_name}/episodes на стримере. Central выдаёт сохранённую историю, стример — текущее окно в памяти. Действуют обычные права и play-токены стрима. Чтение эпизодов и изображений не создаёт и не продлевает сессию просмотра.

Примеры создания, дополнения meta и поиска — в мануале Optic. Сроки хранения описаны в архиве эпизодов.