Эпизоды внешних систем¶

media.episodes.external

media.episodes.external — создание и обновление эпизодов из внешнего источника. Система контроля доступа или внешний анализатор передаёт событие сразу в central, зная имя стрима.

Создание¶

POST /central/api-v4/episodes сохраняет эпизод непосредственно в PostgreSQL. Стрим должен существовать и иметь включённое хранение эпизодов. Знать адрес назначенного стримера или ждать его доступности не требуется.

Первое создание даёт 201. Повтор по ключу (media, opened_at, details.type) даёт 200 с прежним ID и не изменяет данные. Для типа custom ключ использует буквальный custom. Central назначает episode_id и updated_at.

Дополнение и поиск¶

PATCH /central/api-v4/episodes/{episode_id}/meta изменяет произвольный JSON внешней системы по JSON Merge Patch. Харвестинг не затирает это поле. Неустановленное meta отсутствует в JSON эпизода.

JSON-фильтр meta передаётся в query string чтения истории; он ищет вхождение заданной структуры до ограничения страницы. Для записи нужны права management write; play-токен даёт чтение. Полный пример curl — создание, meta и поиск в Optic.