Muro Box Supporto ufficiale per Open API
(Consultare qui il manuale completo.)
Con l'autenticazione tramite chiave API, i servizi di terze parti e gli strumenti di automazione, come Home Assistant, IFTTT o script personalizzati, possono controllare direttamente il carillon: riprodurre brani e playlist, interrompere la riproduzione, modificare le impostazioni del dispositivo e cercare nel catalogo dei brani e delle playlist.
La riproduzione avviene interamente sul carillon stesso. L'API non restituisce file MIDI né link per il download, garantendo la tutela del diritto d'autore e l'integrità dei contenuti musicali.
Che cosa è possibile fare con l'API
- Riprodurre un singolo brano (
play_song) - Riprodurre una playlist; il sistema filtra automaticamente i brani riproducibili in base ai permessi dell'account (
play_playlist) - Interrompere la riproduzione in corso (
stop_playing) - Leggere e aggiornare le impostazioni del dispositivo: velocità del motore, modalità casuale, durata massima di riproduzione, uscita MIDI, attivazione/disattivazione del MIDI Bluetooth (
device_settings) - Cercare brani e playlist per parola chiave, con paginazione e supporto per i nomi multilingue (
search/songs,search/packages)
Come iniziare in 3 passaggi
- Apra Muro Box App → Impostazioni → Chiavi API → Aggiungi. Assegni un nome alla chiave e confermi. La chiave completa verrà mostrata una sola volta: la copi e la salvi subito (non sarà possibile recuperarla in seguito).
- Trovi il numero di serie del Suo dispositivo (
device_sn) nella pagina delle impostazioni del dispositivo dell’App. - Chiami l’API: invii una richiesta POST a
https://api.murobox.com/muro_api/v1/...con la Sua chiave API nell’intestazione.
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"}'
Gli ID dei brani (song_id) e gli ID delle playlist (playlist_id) possono essere copiati direttamente nell’App: «Copia ID brano» nel menu del lettore oppure «Copia ID playlist» nella pagina dei dettagli della playlist.
Note sulla sicurezza e sull’utilizzo
- Le chiavi API equivalgono a password. Il server memorizza esclusivamente le impronte SHA‑256; la chiave originale non può essere recuperata. Non condividerla.
- Ogni chiave consente fino a 60 richieste al minuto (superato tale limite, viene restituito HTTP 429).
- Le chiavi API possono controllare esclusivamente i carillon associati allo stesso account; non possono essere utilizzate per scaricare brani o file MIDI.
- Per la documentazione completa degli endpoint e per una Postman Collection pronta per l'importazione, consultare la Guida utente dell'Open API di Muro Box.


