Muro Box Open API — Integración de la caja de música en su hogar inteligente y en su flujo de automatización

Tres cajas de música mecánicas con cubiertas transparentes dejan a la vista sus engranajes y peines, y llevan grabada la frase «All Memories in One Music Box». El fondo, con una mesa y una estantería de madera cálida, realza la artesanía y el diseño emocional.

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

  1. 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).
  2. 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.
  3. 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.
Muro Box Global
Muro Box Global

Hemos inventado la caja de música que puede reproducir sus propios recuerdos. Esperamos que se convierta en la reliquia familiar de cada familia y les permita preservar sus propios recuerdos únicos.

Todas las entradas