Episodios externos¶

media.episodes.external

media.episodes.external abarca la creación y actualización de episodios desde una fuente externa. Un sistema de control de acceso o analizador externo envía el evento directamente a central usando el nombre del stream.

Creación¶

POST /central/api-v4/episodes guarda un episodio directamente en PostgreSQL. El stream debe existir y tener habilitada la retención de episodios. No es necesario localizar ni esperar al streamer asignado.

La creación inicial devuelve 201. Repetir el mismo (media, opened_at, details.type) devuelve 200 con el ID original sin modificar los datos. Los episodios custom usan el literal custom en la clave. Central asigna episode_id y updated_at.

Anotaciones y búsqueda¶

PATCH /central/api-v4/episodes/{episode_id}/meta actualiza JSON externo arbitrario mediante JSON Merge Patch. La recolección conserva este campo. Si meta no está establecido, se omite del JSON del episodio.

El filtro JSON meta se envía en la query string de la lectura del historial y busca la estructura indicada antes del límite de página. Escribir requiere permiso de modificación de gestión; un token de reproducción permite leer. Consulte el ejemplo completo de curl en Crear, editar meta y buscar en Optic.