Dans cette section3 articles
L’accès API avec le forfait Label
Le forfait Label te permet d’appeler l’API Music24 avec tes propres jetons. Tu gères les jetons dans Paramètres → API. MCP fonctionne avec tous les forfaits.
L’API Music24 te donne les mêmes données de classements, de playlists et de suivis que celles qui font tourner l’app, pour que tu puisses créer tes propres tableaux de bord et automatisations. L’accès à l’API fait partie du forfait Label ($249 par mois, en USD). Avec tous les autres forfaits, Paramètres → API affiche une bannière de mise à niveau à la place de tes jetons.
Où le trouver
Ouvre Paramètres → API dans l’app web, ou Paramètres → API dans l’app iPhone ou Android. La page Accès API liste tes jetons et, sur le web, propose un Démarrage rapide avec un exemple de requête.
Comment fonctionnent les jetons
- Un jeton personnel commence par
m24_. Nous l’affichons une seule fois, à sa création, puis nous n’en gardons que les premiers caractères. - Tu peux avoir 5 jetons actifs. Révoque-en un pour faire de la place à un autre.
- Un jeton appartient à l’espace de travail qui était actif quand tu l’as créé, et lit les données de cet espace. Si tu quittes l’espace de travail, si le propriétaire te retire ou si tu supprimes ton compte, ses jetons cessent de fonctionner.
- Chaque membre d’un espace de travail Label peut créer ses propres jetons, pas seulement le propriétaire.
- Les jetons n’expirent pas. Un jeton fonctionne jusqu’à ce que tu le révoques.
- Un jeton agit en ton nom dans son espace de travail. Il lit des données, et il peut aussi faire la plupart des modifications que tu peux faire dans l’app. Si tu es propriétaire de l’espace de travail, il peut aussi ouvrir sa facturation. Il ne peut pas changer ton e-mail, inviter ou retirer des personnes, changer d’espace de travail ou le renommer, gérer les jetons ni supprimer le compte. Garde-le aussi secret qu’un mot de passe.
Envoyer une requête
Envoie le jeton dans l’en-tête Authorization sous la forme Token m24_…. L’URL de base est https://api.music24.com/trpc. Un GET lit des données. Copie l’exemple de requête depuis Démarrage rapide dans Paramètres → API pour faire ton premier appel, et lis la documentation de l’API complète.
Limites
Chaque personne peut envoyer 30 requêtes par minute à un endpoint. La limite s’applique par utilisateur : avoir plus de jetons ne te donne pas plus de requêtes. Au-delà de la limite, l’API répond TOO_MANY_REQUESTS. Attends une minute et réessaie.
L’API suit les mêmes limites de forfait que l’app, par exemple 365 jours d’historique avec Label.
Besoin de limites plus élevées, d’endpoints sur mesure ou d’un accord de licence ? Écris à [email protected].
Étapes suivantes : Créer et révoquer un jeton, ou utiliser Music24 depuis un client IA (MCP).
Questions
Quel forfait comprend l’API Music24 ?
Le forfait Label. Il comprend les jetons d’API. Aucun autre forfait ni l’essai ne les comprennent. MCP fonctionne avec tous les forfaits et ne fait que lire tes données.
Quelle est la limite de requêtes de l’API ?
30 requêtes par minute et par utilisateur pour chaque endpoint. Écris à [email protected] si tu as besoin de plus.
