# 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.

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](https://hillsmusic.com/apply/?type=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](https://developer.hillsmusic.com/fr/guides/authentication/).
- **Un circuit de test qui ne crée rien.** `POST /ddex/validate` et le dossier SFTP `/test` exécutent toutes les vérifications d’une livraison et renvoient un rapport. Voir [Dossier de test](https://developer.hillsmusic.com/fr/reference/test-folder/).
- **La livraison DDEX.** ERN 4.3 recommandée, versions antérieures acceptées, via l’API ou en SFTP. Voir [Livraison DDEX](https://developer.hillsmusic.com/fr/guides/ddex/).
- **Les webhooks.** Jusqu’à 20 endpoints HTTPS, des événements signés et de nouvelles tentatives en cas d’échec. Voir [Webhooks](https://developer.hillsmusic.com/fr/guides/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](https://developer.hillsmusic.com/fr/mcp/overview/).

## É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](https://developer.hillsmusic.com/fr/changelog/) 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](https://developer.hillsmusic.com/fr/guides/making-requests/#versioning).

Source: https://developer.hillsmusic.com/fr/overview/early-access/