Muro Box unterstützt offiziell Open API.
(Das vollständige Handbuch finden Sie hier.)
Mit der Authentifizierung per API-Schlüssel können Drittanbieterdienste und Automatisierungswerkzeuge – etwa Home Assistant, IFTTT oder Ihre eigenen benutzerdefinierten Skripte – Ihre Muro Box direkt steuern: Musikstücke und Wiedergabelisten abspielen, die Wiedergabe stoppen, Geräteeinstellungen anpassen und den Katalog der Musikstücke und Wiedergabelisten durchsuchen.
Die gesamte Wiedergabe erfolgt auf der Muro Box selbst. Die API gibt weder MIDI-Dateien noch Downloadlinks zurück; dadurch werden der Urheberrechtsschutz und die Integrität der Musikinhalte gewährleistet.
Was Sie mit der API tun können
- Einen einzelnen Titel wiedergeben (
play_song) - Eine Wiedergabeliste wiedergeben; das System filtert anhand der Kontoberechtigungen automatisch die abspielbaren Titel (
play_playlist) - Die aktuelle Wiedergabe stoppen (
stop_playing) - Geräteeinstellungen auslesen und aktualisieren: Motordrehzahl, Zufallsmodus, maximale Wiedergabedauer, MIDI-Ausgang, Bluetooth-MIDI-Umschalter (
device_settings) - Musikstücke und Wiedergabelisten mit Stichwortsuche, Paginierung und Unterstützung für mehrsprachige Namen durchsuchen (
search/songs,search/packages)
Einstieg in 3 Schritten
- Öffnen Sie die Muro Box App → Einstellungen → API-Schlüssel → Hinzufügen. Geben Sie dem Schlüssel einen Namen und bestätigen Sie. Der vollständige Schlüssel wird nur einmal angezeigt – kopieren und speichern Sie ihn sofort (er ist später nicht mehr abrufbar).
- Die Seriennummer Ihres Geräts (
device_sn) finden Sie auf der Seite mit den Geräteeinstellungen der App. - Rufen Sie die API auf: Senden Sie eine POST-Anfrage an
https://api.murobox.com/muro_api/v1/...und übergeben Sie dabei Ihren API-Schlüssel im 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"}'
Song-IDs (song_id) und Playlist-IDs (playlist_id) können direkt in der App kopiert werden: über „Copy Song ID“ im Player-Menü oder über „Copy Playlist ID“ auf der Playlist-Detailseite.
Sicherheits- und Nutzungshinweise
- API-Schlüssel sind wie Passwörter zu behandeln. Der Server speichert ausschließlich SHA‑256-Fingerabdrücke; der ursprüngliche Schlüssel kann nicht wiederhergestellt werden. Geben Sie ihn nicht weiter.
- Pro Schlüssel sind bis zu 60 Anfragen pro Minute möglich (bei Überschreitung wird HTTP 429 zurückgegeben).
- API-Schlüssel können ausschließlich Muro-Box-Geräte steuern, die demselben Konto zugeordnet sind; sie lassen sich nicht zum Herunterladen von Musikstücken oder MIDI-Dateien verwenden.
- Die vollständige Endpunktdokumentation sowie eine importbereite Postman-Collection finden Sie bitte im Muro Box Open-API-Benutzerhandbuch.
