Muro Box ofrece soporte oficial para Open API.
(Consulte aquí el manual completo.)
Mediante la autenticación con clave de API, los servicios de terceros y las herramientas de automatización —como Home Assistant, IFTTT o sus propios scripts personalizados— pueden controlar directamente su caja de música: reproducir canciones y listas de reproducción, detener la reproducción, ajustar la configuración del dispositivo y buscar en el catálogo de canciones y listas de reproducción.
Toda la reproducción se realiza en la propia caja de música. La API no devuelve archivos MIDI ni enlaces de descarga, lo que garantiza la protección de los derechos de autor y la integridad del contenido musical.
Qué puede hacer con la API
- Reproducir una sola canción (
play_song) - Reproducir una lista de reproducción; el sistema filtra automáticamente las canciones reproducibles según los permisos de la cuenta (
play_playlist) - Detener la reproducción actual (
stop_playing) - Leer y actualizar la configuración del dispositivo: velocidad del motor, modo aleatorio, tiempo máximo de reproducción, salida MIDI y activación o desactivación de MIDI por Bluetooth (
device_settings) - Buscar canciones y listas de reproducción por palabra clave, con paginación y compatibilidad con nombres en varios idiomas (
search/songs,search/packages)
Cómo comenzar en 3 pasos
- Abra Muro Box App → Ajustes → Claves de API → Añadir. Asigne un nombre a la clave y confirme. La clave completa solo se mostrará una vez; cópiela y guárdela de inmediato (no se podrá recuperar posteriormente).
- Busque el número de serie de su dispositivo (
device_sn) en la página de configuración del dispositivo dentro de la aplicación. - Realice una llamada a la API: envíe una solicitud POST a
https://api.murobox.com/muro_api/v1/...con su clave de API en el encabezado.
curl -X POST https://api.murobox.com/muro_api/v1/devices/play_song/
-H "api-key: YOUR_API_KEY
-H "Content-Type: application/json"
-d '{"device_sn": "YOUR_DEVICE_SN", "song_id": "SONG_ID"}'
Los ID de canción (song_id) y los ID de lista de reproducción (playlist_id) se pueden copiar directamente en la aplicación: «Copiar ID de canción» en el menú del reproductor, o «Copiar ID de lista de reproducción» en la página de detalles de la lista de reproducción.
Notas de seguridad y uso
- Las claves de API equivalen a contraseñas. El servidor solo almacena huellas digitales SHA‑256; la clave original no se puede recuperar. No la comparta.
- Cada clave permite hasta 60 solicitudes por minuto (si se supera este límite, se devuelve HTTP 429).
- Las claves solo pueden controlar las cajas de música vinculadas a la misma cuenta; no pueden utilizarse para descargar canciones ni archivos MIDI.
- Para acceder a la documentación completa de los puntos de conexión y a una colección de Postman lista para importar, consulte la Guía de usuario de la Open API de Muro Box.


