Accès et offres
L’API HILLS, les webhooks et le MCP sont inclus dans les offres Enterprise et Custom. Qui crée les clés, limites de débit et obtention de l’accès.
Mis à jour le
L’API HILLS est en ligne pour les comptes clients des offres Enterprise et Custom.
Offres
| Enterprise | Custom | |
|---|---|---|
| API REST et DDEX via l’API | Oui | Oui |
| Webhooks | Oui | Oui |
| Requêtes par minute et par clé | 120 | Ajusté à votre volume (600 sauf accord contraire) |
Sur les autres offres, les clés ne fonctionnent pas et renvoient 403 api_not_in_plan, et il est impossible d’ajouter des endpoints webhook. Si vous passez à une offre inférieure, les clés existantes cessent de fonctionner jusqu’à ce que l’offre inclue de nouveau l’API. Rien n’est supprimé. Vous pouvez toujours tester des fichiers DDEX depuis la page DDEX de l’application web et votre dossier SFTP /test.
Pour passer à Enterprise ou Custom, contactez votre interlocuteur HILLS Music. Si vous n’êtes pas encore client, demandez l’accès à l’API. Dites-nous ce que vous voulez connecter, et combien de sorties et de requêtes vous prévoyez, approximativement.
Ce que vous obtenez
- Des clés d’API. Un seul type de clé,
hm_live_…, avec ses propres scopes et une date d’expiration facultative. Voir Authentification. - Un circuit de test qui ne crée rien.
POST /ddex/validateet le dossier SFTP/testexécutent toutes les vérifications d’une livraison et renvoient un rapport. Voir Dossier de test. - La livraison DDEX. ERN 4.3 recommandée, versions antérieures acceptées, via l’API ou en SFTP. Voir Livraison DDEX.
- Les webhooks. Jusqu’à 20 endpoints HTTPS, des événements signés et de nouvelles tentatives en cas d’échec. Voir Webhooks.
- Le serveur MCP. Connectez des assistants IA à votre espace de travail. Voir plus bas.
Qui peut créer des clés
Les clés se créent sur la page Developers de l’application web HILLS. Le propriétaire du compte peut toujours en créer. Un membre de l’équipe le peut si son rôle dispose de la permission API keys, définie sous Settings → Team. Les artistes et labels rattachés à votre compte ne peuvent pas créer de clés : l’API est la vôtre, et chaque réponse couvre votre compte ainsi que les artistes et labels qui lui sont rattachés.
Serveur MCP
Le serveur MCP, à l’adresse https://mcp.hillsmusic.com, permet aux assistants IA de lire votre catalogue, le statut de vos sorties, vos écoutes et revenus, vos relevés et vos demandes. Il propose 10 outils en lecture seule. Chacun se connecte avec son propre compte HILLS via OAuth 2.1, sans clé d’API. Les comptes clients et les membres de leur équipe peuvent le connecter ; les membres de l’équipe ont besoin de la permission de rôle indiquée pour chaque outil. Voir Serveur MCP.
Évolutions
L’API v1 est stable. Des champs s’y ajoutent au fil du temps. Lorsqu’un élément doit disparaître, son retrait est annoncé dans le journal des modifications avec une date de fin, et les réponses qui l’utilisent portent d’ici là les en-têtes Deprecation et Sunset. Voir Faire des requêtes.