Muro Box Open API — de muziekdoos integreren in uw slimme woning en automatiseringsworkflow

Drie mechanische muziekdozen met transparante deksels tonen hun tandwielen en kammen. Op de dozen is 'All Memories in One Music Box' gegraveerd. Een warme achtergrond van een houten tafel en een boekenkast benadrukt het vakmanschap en het emotionele ontwerp.

Muro Box Officiële ondersteuning voor Open API

(Raadpleeg hier de volledige handleiding.)

Met authenticatie via een API-sleutel kunnen diensten van derden en automatiseringstools, zoals Home Assistant, IFTTT of uw eigen aangepaste scripts, uw muziekdoos rechtstreeks bedienen: nummers en afspeellijsten afspelen, het afspelen stoppen, apparaatinstellingen aanpassen en de catalogus van nummers en afspeellijsten doorzoeken.

Het afspelen gebeurt volledig op de muziekdoos zelf. De API retourneert geen MIDI-bestanden of downloadlinks, waardoor de auteursrechtelijke bescherming en de integriteit van de muziekinhoud worden gewaarborgd.

Wat u met de API kunt doen

  • Eén nummer afspelen (play_song)
  • Een afspeellijst afspelen; het systeem filtert automatisch de afspeelbare nummers op basis van de accountrechten (play_playlist)
  • Het huidige afspelen stoppen (stop_playing)
  • Apparaatinstellingen uitlezen en bijwerken: motorsnelheid, willekeurige afspeelmodus, maximale afspeeltijd, MIDI-uitvoer, Bluetooth-MIDI-schakelaar (device_settings)
  • Nummers en afspeellijsten zoeken op trefwoord, met paginering en ondersteuning voor meertalige namen (search/songs, search/packages)

Aan de slag in 3 stappen

  1. Open de Muro Box App → Instellingen → API-sleutels → Toevoegen. Geef de sleutel een naam en bevestig. De volledige sleutel wordt slechts één keer weergegeven—kopieer en bewaar deze onmiddellijk (deze kan later niet meer worden opgevraagd).
  2. Zoek het serienummer van uw apparaat (device_sn) op de pagina Apparaatinstellingen in de app.
  3. Roep de API aan: stuur een POST-verzoek naar https://api.murobox.com/muro_api/v1/... met uw API-sleutel in de header.
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"}'

Nummer-ID's (song_id) en afspeellijst-ID's (playlist_id) kunnen rechtstreeks in de Muro Box App worden gekopieerd: “Nummer-ID kopiëren” in het spelermenu, of “Afspeellijst-ID kopiëren” op de detailpagina van de afspeellijst.

Veiligheids- en gebruiksinformatie

  • API-sleutels zijn gelijkwaardig aan wachtwoorden. De server slaat uitsluitend SHA‑256-vingerafdrukken op; de oorspronkelijke sleutel kan niet worden hersteld. Deel deze sleutel niet.
  • Elke sleutel staat maximaal 60 verzoeken per minuut toe (bij overschrijding wordt HTTP 429 geretourneerd).
  • Sleutels kunnen alleen muziekdozen aansturen die aan hetzelfde account zijn gekoppeld; ze kunnen niet worden gebruikt om nummers of MIDI-bestanden te downloaden.
  • Voor volledige documentatie van de endpoints en een Postman-collectie die u direct kunt importeren, verwijzen wij u naar de Muro Box Open API-gebruikershandleiding.
Muro Box Wereldwijd
Muro Box Wereldwijd

Wij hebben de muziekdoos uitgevonden die uw eigen herinneringen kan laten klinken. Wij hopen dat de muziekdoos in elk gezin een erfstuk wordt waarmee het gezin de eigen unieke herinneringen bewaart.

Alle berichten