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
- 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).
- Zoek het serienummer van uw apparaat (
device_sn) op de pagina Apparaatinstellingen in de app. - 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.


