Muro Box Open API — Intégrer la boîte à musique à votre maison connectée et à votre flux d’automatisation

Trois boîtes à musique mécaniques à couvercle transparent laissent apparaître leurs engrenages et leurs peignes ; elles portent la gravure « All Memories in One Music Box ». Un arrière-plan chaleureux composé d'une table en bois et d'une bibliothèque met en valeur le savoir-faire artisanal et la dimension émotionnelle du design.

Muro Box prend officiellement en charge l’API ouverte !

(Consultez ici le manuel complet.)

Grâce à l’authentification par clé API, des services tiers et des outils d’automatisation — tels que Home Assistant, IFTTT ou vos propres scripts personnalisés — peuvent contrôler directement votre boîte à musique : lire des morceaux et des listes de lecture, arrêter la lecture, modifier les paramètres de l’appareil et rechercher dans le catalogue des morceaux et des listes de lecture.

La lecture s’effectue entièrement sur la boîte à musique elle-même. L’API ne renvoie pas de fichiers MIDI ni de liens de téléchargement, ce qui garantit la protection des droits d’auteur et l’intégrité du contenu musical.

Ce que vous pouvez faire avec l’API

  • Lire un seul morceau (play_song)
  • Lire une liste de lecture ; le système filtre automatiquement les morceaux pouvant être lus en fonction des autorisations du compte (play_playlist)
  • Arrêter la lecture en cours (stop_playing)
  • Lire et mettre à jour les paramètres de l'appareil : vitesse du moteur, mode aléatoire, durée de lecture maximale, sortie MIDI, commutateur MIDI Bluetooth (device_settings)
  • Rechercher des morceaux et des listes de lecture par mot-clé, avec pagination et prise en charge des noms multilingues (search/songs, search/packages)

Premiers pas en 3 étapes

  1. Ouvrez l'application Muro Box App → Réglages → Clés API → Ajouter. Donnez un nom à la clé, puis confirmez. La clé complète ne sera affichée qu'une seule fois : copiez-la et conservez-la immédiatement (elle ne pourra pas être récupérée ultérieurement).
  2. Recherchez le numéro de série de votre appareil (device_sn) sur la page des paramètres de l’appareil, dans l’application.
  3. Appelez l’API : envoyez une requête POST à https://api.murobox.com/muro_api/v1/... en plaçant votre clé API dans l’en-tête.
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"}'

Les identifiants de morceau (song_id) et les identifiants de liste de lecture (playlist_id) peuvent être copiés directement dans l'application Muro Box : « Copier l'identifiant du morceau » dans le menu du lecteur, ou « Copier l'identifiant de la liste de lecture » dans la page de détails de la liste de lecture.

Notes de sécurité et d'utilisation

  • Les clés d'API sont équivalentes à des mots de passe. Le serveur ne conserve que des empreintes SHA‑256 ; la clé d'origine ne peut être récupérée. Ne la partagez pas.
  • Chaque clé permet jusqu'à 60 requêtes par minute (tout dépassement renvoie une erreur HTTP 429).
  • Les clés ne peuvent piloter que les boîtes à musique associées au même compte ; elles ne permettent pas de télécharger de morceaux ni de fichiers MIDI.
  • Pour obtenir une documentation complète des points de terminaison et une collection Postman prête à être importée, veuillez consulter le Guide d'utilisation de l'API ouverte de Muro Box.
Muro Box Global
Muro Box Global

Nous avons inventé la boîte à musique capable de jouer vos propres souvenirs. Nous espérons qu’elle deviendra, pour chaque famille, un objet de transmission afin de préserver ses souvenirs uniques.

Tous les articles