# API REST para plataformas OTT | Vodlix **Source:** https://vodlix.com/es/features/restful-api **Summary:** Controla tu plataforma de streaming desde el código: vídeos, series, canales en directo, imágenes y listas de contenido con una API que cubre el panel. **Publisher:** Vodlix --- ## API RESTful Consigue una API REST potente y segura para integrar rápidamente, automatizar procesos y agilizar tus flujos de trabajo. - **Feature Plan:** 2 - core-platform - back-end ## API REST para tu plataforma de streaming Controla el catálogo, las imágenes, los canales en directo, el merchandising y los informes con una API REST que replica el panel de administración. La llamada «Add New Video» en la documentación de la API de la plataforma en un portátil, con el mismo título abierto en una app móvil Documentación de la API de “Update Content Thumbs”, que define las imágenes vertical, horizontal y de logo de un título a partir de URL de imágenes ### Imágenes y canales en directo por API Con la API de Vodlix, las imágenes se asignan por URL en lugar de subirse a mano. Una llamada define las imágenes vertical, horizontal y de logo de un título, y otra elige qué fotograma generado sirve de miniatura. Los canales en directo se gestionan como los vídeos: se crean a partir de una URL de stream, se actualizan, se publican o despublican y se envían a la papelera o se restauran, así que el contenido lineal se automatiza igual que el contenido bajo demanda. En un catálogo grande o que cambia a menudo, las imágenes se mantienen coherentes sin que nadie tenga que subir archivos uno a uno. #### API REST Familiar y predecible. #### Replica el panel Si conoces la interfaz, conoces la API. #### Ciclo de vida completo Crear, publicar, despublicar, restaurar. Documentación de la API de “Upload with URL”, que incorpora un vídeo desde la URL de un archivo en almacenamiento público, S3 o Wasabi ### Gestiona el catálogo de forma programática La API REST de Vodlix te permite controlar el catálogo de forma programática, igual que en el panel de administración. Los vídeos se pueden crear, actualizar, publicar o despublicar, y enviar a la papelera o restaurar. Las series y temporadas se crean, actualizan y publican del mismo modo, y los episodios se vinculan a una temporada o se desvinculan de ella. Los vídeos nuevos se incorporan indicando a la plataforma la URL de un archivo, pública o en tu propio almacenamiento S3 o Wasabi: la plataforma descarga y procesa el archivo en segundo plano y devuelve un ID de vídeo para hacer el seguimiento. Para los operadores OTT con sistemas existentes, la gestión del catálogo puede automatizarse en lugar de hacerse a mano. Página de inicio de la tienda con las filas “Top 10” y “Rent the Latest”, listas de contenido que una llamada a la API puede activar y desactivar ### Merchandising y listas de contenido bajo control de la API La API de Vodlix te da el control del merchandising: las listas de contenido, los grupos de listas, sus elementos y su orden pueden crearse y gestionarse de forma programática. Las listas se pueden activar y desactivar, de modo que una fila de temporada se apaga con una llamada a la API en lugar de reconstruirse. Así, los sistemas de programación y las herramientas de planificación de contenidos pueden dar forma a la página de inicio automáticamente. Tener el merchandising bajo control de la API es lo que permite escalar los flujos editoriales. - mx-auto Tabla de herramientas de MCP Access con información de la plataforma, recuento de contenidos y usuarios, navegación por el catálogo y un resumen de ventas ### Endpoints de referencia e informes La API de Vodlix ofrece llamadas de referencia e informes: ID de categoría, recuento del catálogo y de usuarios, un resumen de ventas para cualquier rango de fechas y datos de la plataforma como la versión del software. Las integraciones saben siempre con qué están trabajando y pueden adaptarse a los cambios de la plataforma. El acceso funciona con claves API creadas en el panel: una clave de servidor para los procesos de back-end y una clave de cliente para el código del navegador, que nunca puede llegar a las rutas de administración. Las mismas llamadas están disponibles para los asistentes de IA a través del conector MCP de la plataforma. ### Dónde suele rentabilizarse Los casos habituales son la migración, la ingesta y los informes. Trasladar un catálogo desde otra plataforma es un trabajo de la API y no una tarea manual, y marca la diferencia entre un lanzamiento que no espera a nadie y otro que se mide en meses. La ingesta recurrente desde un distribuidor o un flujo de producción funciona de forma desatendida una vez programada. Los informes llevan las cifras a las herramientas que tu equipo financiero ya utiliza, en lugar de pedir a alguien que exporte una pantalla cada lunes. También conecta tu plataforma con el resto de tu negocio. Envía un título nuevo a tu CMS y a tu web de marketing en cuanto se publique, o pasa tus [listas de contenido](/es/features/content-lists) a un servicio de recomendaciones y vuelve a escribir los resultados. Cuando una integración necesita más de lo que ofrece la API por sí sola, nuestro [servicio de plugins a medida](/es/services/custom-plugin) desarrolla la pieza que falta sobre la misma plataforma. La analítica está disponible a través de la API cuando hay un servicio de estadísticas configurado en tu cloud; conviene confirmarlo durante la puesta en marcha en lugar de descubrirlo más tarde. La página de [informes y analítica](/es/features/reports-and-analytics) explica qué se mide. **Q: ¿Qué puede controlar la API REST de Vodlix?** La API REST de Vodlix controla el catálogo, incluidos vídeos, series, temporadas y episodios, además de imágenes, canales en directo, listas de contenido y merchandising, y datos de referencia e informes. **Q: ¿Subo los archivos de vídeo a través de la API de Vodlix?** Los vídeos nuevos se incorporan a través de la API de Vodlix indicando una URL HTTPS pública. Vodlix descarga y transcodifica el archivo, así que no tienes que transmitir subidas binarias a través de tu propia infraestructura. **Q: ¿La API de Vodlix coincide con el panel de administración?** Sí. La API REST de Vodlix replica el panel de administración, con convenciones REST conocidas y respuestas predecibles, así que quien conoce la interfaz sabe más o menos qué puede hacer la API. **Q: ¿Puedo gestionar las listas de contenido a través de la API de Vodlix?** Sí. Las listas de contenido de Vodlix, los grupos de listas, sus elementos y su orden pueden crearse, actualizarse, activarse y desactivarse a través de la API, de modo que el merchandising puede automatizarse. **Q: ¿Qué datos de informes ofrece la API de Vodlix?** La API de Vodlix ofrece el recuento del catálogo y de usuarios, un resumen de ventas para un rango de fechas, los ID de categoría y datos de la plataforma como la versión del software, para que las integraciones sepan siempre con qué están trabajando. **Q: ¿Los ID de categoría son los mismos en todos los clouds de Vodlix?** No, y es el error más común. Las categorías son propias de cada cloud, así que lee la lista de categorías de la plataforma con la que trabajas y usa los ID que devuelve, en lugar de suponer que un nombre corresponde al mismo número en todas partes. **Q: ¿Podemos obtener analítica a través de la API?** Sí, cuando hay un servicio de estadísticas configurado en tu cloud, con las cifras principales, la actividad en tiempo real y el contenido con mejor rendimiento. Conviene confirmarlo durante la puesta en marcha, porque se aprovisiona por separado de las operaciones del catálogo. **Q: ¿Es útil la API para migrar desde otra plataforma?** Es uno de los motivos más habituales por los que los operadores la usan. Trasladar un catálogo de forma programática convierte una migración en un trabajo repetible en lugar de meses de introducción manual, y puede volver a ejecutarse para recoger todo lo que haya cambiado durante el traslado. **Q: ¿Cómo se autentican las integraciones con la API de Vodlix?** Con una clave API creada en “Apps & APIs” del panel y enviada en la cabecera X-Api-Key. Una clave de servidor actúa con los permisos del usuario al que pertenece y puede llegar a las rutas de administración, así que debe usarse en un back-end. Una clave de cliente es segura para el código del navegador y está bloqueada en todas las rutas de administración. Las claves pueden tener fecha de caducidad, y eliminar una clave la revoca al instante.