# API HILLS

> Connectez vos systèmes à HILLS Music : lisez catalogue, livraisons et revenus, livrez vos sorties en DDEX, recevez des webhooks et connectez l’IA via MCP.

L’API HILLS connecte vos propres systèmes à la plateforme HILLS Music. Labels, distributeurs et détenteurs de catalogues l’utilisent pour lire les données de leur catalogue, de leurs livraisons et de leurs royalties, et pour livrer leurs sorties, sans tout faire dans le navigateur.

L’API est en ligne. Elle est incluse dans les offres Enterprise et Custom. Voir [Accès et offres](https://developer.hillsmusic.com/fr/overview/early-access/).

## Ce que vous pouvez construire

- **Synchronisation du catalogue.** Lisez chaque sortie avec ses titres, son statut de vérification et son statut sur chaque plateforme. Utilisez `updated_since` pour ne synchroniser que ce qui a changé.
- **Livraison des sorties en DDEX.** Envoyez des lots ERN (4.3 recommandée) via l’API ou en SFTP. Chaque sortie devient un brouillon dans votre catalogue, puis passe par la vérification et la livraison aux plateformes. Testez d’abord un lot : rien n’est créé.
- **Suivi des livraisons.** Suivez chaque sortie plateforme par plateforme, et recevez un webhook quand elle est approuvée, passe en ligne ou demande une correction.
- **Reporting.** Importez les revenus par mois, par sortie ou par plateforme, votre solde et vos versements, ainsi que les statistiques de vos smart links, dans vos outils de BI ou de comptabilité.
- **Intégration des artistes.** Listez vos artistes et labels, et invitez-en de nouveaux.
- **Assistants IA.** Connectez Claude, ChatGPT et d’autres assistants à votre espace de travail grâce au serveur MCP.

Les sorties n’entrent dans HILLS qu’en DDEX ERN ou par l’application web. L’API ne crée ni ne modifie une sortie champ par champ, et elle n’a pas d’envoi séparé pour l’audio ou les pochettes : les fichiers voyagent dans le lot DDEX.

## Les briques

| | |
| --- | --- |
| API REST | `https://api.hillsmusic.com/v1`, JSON sur HTTPS, clés d’API Bearer. Commencez par le [Démarrage rapide](https://developer.hillsmusic.com/fr/guides/quickstart/). |
| DDEX | `POST /ddex/validate` pour tester, `POST /ddex` et l’envoi direct pour livrer, plus le SFTP avec les dossiers `/test` et `/production`. Voir [Livraison DDEX](https://developer.hillsmusic.com/fr/guides/ddex/). |
| Webhooks | Événements signés pour les sorties, la livraison aux plateformes, le DDEX, les relevés, les versements, les demandes et le support en direct. Voir [Webhooks](https://developer.hillsmusic.com/fr/guides/webhooks/). |
| Serveur MCP | `https://mcp.hillsmusic.com`, 10 outils en lecture seule, connexion OAuth 2.1 avec votre compte HILLS. Voir [Serveur MCP](https://developer.hillsmusic.com/fr/mcp/overview/). |

## Fonctionnement de l’accès

Il n’existe qu’un seul type de clé d’API : `hm_live_…`. Le propriétaire du compte, ou un membre de l’équipe disposant de la permission API keys, crée les clés sur la page **Developers** de l’application web HILLS. Chaque clé a ses propres scopes et une date d’expiration facultative.

Il n’y a pas de sandbox séparée. Pour essayer une livraison DDEX, utilisez la même clé avec `POST /ddex/validate`, ou le dossier SFTP `/test`. Les deux exécutent toutes les vérifications et ne créent rien. Voir [Dossier de test](https://developer.hillsmusic.com/fr/reference/test-folder/).

## Et ensuite

- [Démarrage rapide](https://developer.hillsmusic.com/fr/guides/quickstart/) : créez une clé et faites vos premiers appels.
- [Accès et offres](https://developer.hillsmusic.com/fr/overview/early-access/) : qui peut utiliser l’API, et ses limites.
- [Référence API](https://developer.hillsmusic.com/fr/reference/) : tous les endpoints.

Source: https://developer.hillsmusic.com/fr/overview/introduction/