HILLS API
Verbinden Sie Ihre Systeme mit HILLS Music: Katalog, Auslieferungen und Erlöse lesen, Releases per DDEX liefern, Webhooks nutzen, KI per MCP anbinden.
Aktualisiert
Die HILLS API verbindet Ihre eigenen Systeme mit der Plattform von HILLS Music. Labels, Vertriebe und Kataloginhaber lesen damit ihre Katalog-, Liefer- und Royalty-Daten und liefern Releases, ohne ausschließlich im Browser arbeiten zu müssen.
Die API ist live. Sie ist Teil der Tarife Enterprise und Custom. Siehe Zugang und Tarife.
Was Sie bauen können
- Katalogabgleich. Lesen Sie jedes Release mit seinen Tracks, dem Prüfstatus und dem Status in jedem Store. Mit
updated_sincesynchronisieren Sie nur, was sich geändert hat. - Release-Lieferung per DDEX. Senden Sie ERN-Batches (empfohlen: 4.3) per API oder SFTP. Jedes Release wird ein Entwurf in Ihrem Katalog und durchläuft Prüfung und Auslieferung an die Stores. Testen Sie einen Batch vorher: Dabei wird nichts angelegt.
- Auslieferungsstatus verfolgen. Verfolgen Sie jedes Release Store für Store und erhalten Sie einen Webhook, wenn es freigegeben wird, live geht oder eine Korrektur braucht.
- Reporting. Übernehmen Sie Erlöse nach Monat, Release oder Store, Ihr Guthaben und Ihre Auszahlungen sowie Smart-Link-Statistiken in Ihr BI- oder Buchhaltungssystem.
- Artist-Onboarding. Listen Sie Ihre Artists und Labels auf und laden Sie neue ein.
- KI-Assistenten. Verbinden Sie Claude, ChatGPT und andere Assistenten über den MCP-Server mit Ihrem Workspace.
Releases gelangen nur als DDEX ERN oder über die Web-App zu HILLS. Einzelne Releases Feld für Feld anlegen oder bearbeiten kann die API nicht, und einen eigenen Upload für Audio oder Artwork gibt es nicht: Die Dateien reisen im DDEX-Batch mit.
Die Bausteine
| REST API | https://api.hillsmusic.com/v1, JSON über HTTPS, API-Schlüssel als Bearer-Token. Beginnen Sie mit dem Schnellstart. |
| DDEX | POST /ddex/validate zum Testen, POST /ddex und Direkt-Uploads zum Liefern, dazu SFTP mit den Ordnern /test und /production. Siehe DDEX-Auslieferung. |
| Webhooks | Signierte Events zu Releases, Auslieferung an die Stores, DDEX, Abrechnungen, Auszahlungen, Anfragen und Live-Support. Siehe Webhooks. |
| MCP-Server | https://mcp.hillsmusic.com, 10 rein lesende Tools, Anmeldung per OAuth 2.1 mit Ihrem HILLS-Konto. Siehe MCP-Server. |
So funktioniert der Zugang
Es gibt eine Art von API-Schlüssel: hm_live_…. Der Kontoinhaber oder ein Teammitglied mit der Berechtigung für API-Schlüssel erstellt Schlüssel auf der Seite Developers der HILLS Web-App. Jeder Schlüssel hat eigene Scopes und optional ein Ablaufdatum.
Eine separate Sandbox gibt es nicht. Um eine DDEX-Auslieferung auszuprobieren, verwenden Sie denselben Schlüssel mit POST /ddex/validate oder den SFTP-Ordner /test. Beide durchlaufen alle Prüfungen und legen nichts an. Siehe Testordner.
Weiter
- Schnellstart: einen Schlüssel erstellen und die ersten Aufrufe senden.
- Zugang und Tarife: wer die API nutzen kann und welche Limits gelten.
- API-Referenz: alle Endpunkte.