API de programaciones
API de Programaciones
Crea y gestiona programaciones de contenido basadas en tiempo vía API.
Listar programaciones
`` GET /v1/schedules ``
La respuesta incluye nombres de programaciones, estado, conteo de reglas e información de destinos.
Crear programación
`` POST /v1/schedules ``
Cuerpo de la petición: ``json { "name": "Weekday Menu Rotation", "is_active": true, "rules": [ { "playlist_id": "pl_breakfast", "start_time": "06:00", "end_time": "11:00", "days": ["MON", "TUE", "WED", "THU", "FRI"], "priority": 30 }, { "playlist_id": "pl_lunch", "start_time": "11:00", "end_time": "16:00", "days": ["MON", "TUE", "WED", "THU", "FRI"], "priority": 30 }, { "playlist_id": "pl_dinner", "start_time": "16:00", "end_time": "23:00", "days": ["MON", "TUE", "WED", "THU", "FRI"], "priority": 30 } ], "targets": [ { "type": "tag", "value": "menu-board" } ] } ``
Usar RRULE
Para patrones de recurrencia complejos:
``json { "playlist_id": "pl_special", "start_time": "12:00", "end_time": "14:00", "rrule": "FREQ=WEEKLY;BYDAY=TH", "priority": 50 } ``
Usa la API de Schedules para sincronizar con tus sistemas de negocio. Por ejemplo, integra con tu POS para activar automáticamente las listas de happy hour cuando empieza una promoción.
Obtener detalle de programación
`` GET /v1/schedules/:id ``
Actualizar programación
`` PATCH /v1/schedules/:id ``
Activar/Desactivar
`` POST /v1/schedules/:id/activate POST /v1/schedules/:id/deactivate ``
Eliminar programación
`` DELETE /v1/schedules/:id ``
Evaluar la programación activa
Comprueba qué lista estaría activa para un dispositivo ahora mismo:
`` GET /v1/devices/:id/active-schedule ``
Devuelve la regla de programación y la lista activas en ese momento según la evaluación de prioridades.
Los horarios de programación usan la zona horaria por defecto de la organización. Si operas en varias zonas horarias, asegúrate de que tus llamadas API lo tienen en cuenta. Incluye información de zona horaria en la lógica de tu integración.