Episódios externos¶

media.episodes.external

media.episodes.external abrange a criação e atualização de episódios de uma fonte externa. Um sistema de controle de acesso ou analisador externo envia o evento diretamente ao central usando o nome do stream.

Criação¶

POST /central/api-v4/episodes armazena um episódio diretamente no PostgreSQL. O stream deve existir e ter a retenção de episódios habilitada. Não é necessário localizar nem esperar pelo streamer atribuído.

A criação inicial retorna 201. Repetir o mesmo (media, opened_at, details.type) retorna 200 com o ID original sem alterar os dados. Episódios custom usam o literal custom na chave. O central atribui episode_id e updated_at.

Anotações e busca¶

PATCH /central/api-v4/episodes/{episode_id}/meta atualiza JSON externo arbitrário usando JSON Merge Patch. A coleta preserva esse campo. Se meta não estiver definido, ele é omitido do JSON do episódio.

O filtro JSON meta vai na query string da leitura do histórico e busca a estrutura indicada antes do limite da página. Escrever exige permissão de alteração de gestão; um token de reprodução permite ler. Veja o exemplo completo de curl em Criar, editar meta e buscar no Optic.