Muro Box Open API — Portare il carillon nella casa intelligente e nel flusso di automazione

Tre carillon meccanici con coperchi trasparenti lasciano vedere ingranaggi e pettini e recano incisa la scritta «All Memories in One Music Box». Uno sfondo con un tavolo in legno dai toni caldi e una libreria mette in risalto la maestria artigianale e il design emozionale.

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

  1. 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).
  2. Trovi il numero di serie del Suo dispositivo (device_sn) nella pagina delle impostazioni del dispositivo dell’App.
  3. 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.
Muro Box Global
Muro Box Global

Abbiamo inventato il carillon in grado di suonare i Suoi ricordi personali. Auspichiamo che, per ciascuna famiglia, il carillon diventi un cimelio di famiglia destinato a custodire i propri ricordi unici.

Tutti gli articoli

Informazioni su Tevofy Technology Ltd.

«Raccontare le vostre storie con la tecnologia» è la visione della nostra azienda. Speriamo che la tecnologia non solo ci renda la vita più comoda, ma accorci anche le distanze tra le persone.

Ci segua per ricevere gli ultimi aggiornamenti e il codice coupon.

Articoli recenti

Seguiteci