API de listas
API de Listas de Reproducción
Crea, gestiona y despliega listas de reproducción programáticamente.
Listar listas de reproducción
`` GET /v1/playlists ``
Parámetros de consulta:
page,limit— Paginaciónsearch— Buscar por nombre
Respuesta: ``json { "success": true, "data": [ { "id": "pl_abc123", "name": "Morning Menu", "mode": "sequential", "item_count": 5, "total_duration": 50, "created_at": "2025-01-15T10:30:00Z", "updated_at": "2025-01-16T14:00:00Z" } ] } ``
Crear lista de reproducción
`` POST /v1/playlists ``
Cuerpo de la petición: ``json { "name": "Happy Hour Specials", "mode": "sequential", "items": [ { "content_id": "asset_abc", "duration": 10 }, { "content_id": "asset_def", "duration": 15 } ] } ``
Modos: sequential, shuffle, weighted
Para el modo weighted, incluye weight en cada elemento: ``json { "content_id": "asset_abc", "duration": 10, "weight": 60 } ``
Obtener detalle de la lista
`` GET /v1/playlists/:id ``
Actualizar lista
`` PATCH /v1/playlists/:id ``
Añadir elemento a la lista
`` POST /v1/playlists/:id/items ``
Eliminar elemento de la lista
`` DELETE /v1/playlists/:id/items/:item_id ``
Desplegar lista
`` POST /v1/playlists/:id/deploy ``
Cuerpo de la petición: ``json { "targets": [ { "type": "store", "id": "store_abc" }, { "type": "device", "id": "dev_xyz" }, { "type": "tag", "value": "menu-board" } ] } ``
Usa el endpoint de despliegue para automatizar la distribución de contenido. Por ejemplo, lanza un despliegue de lista de reproducción cada vez que tu sistema POS actualice el menú.
Eliminar lista
`` DELETE /v1/playlists/:id ``
Desplegar una lista vía API genera un nuevo manifest y lo envía a los dispositivos. Asegúrate de que la lista contiene elementos de contenido válidos antes de desplegar para evitar pantallas en negro.