Zugang und Tarife
HILLS API, Webhooks und MCP sind Teil der Tarife Enterprise und Custom: wer Schlüssel erstellen kann, die Rate Limits und wie Sie Zugang erhalten.
Aktualisiert
Die HILLS API ist für Kundenkonten in den Tarifen Enterprise und Custom live.
Tarife
| Enterprise | Custom | |
|---|---|---|
| REST API und DDEX über die API | Ja | Ja |
| Webhooks | Ja | Ja |
| Anfragen pro Minute und Schlüssel | 120 | Auf Ihr Volumen abgestimmt (600, sofern nicht anders vereinbart) |
In anderen Tarifen funktionieren Schlüssel nicht und antworten mit 403 api_not_in_plan; Webhook-Endpunkte lassen sich dort nicht anlegen. Wird Ihr Tarif herabgestuft, funktionieren bestehende Schlüssel erst wieder, wenn der Tarif die API wieder enthält. Gelöscht wird nichts. DDEX-Dateien können Sie weiterhin auf der DDEX-Seite der Web-App und in Ihrem SFTP-Ordner /test testen.
Für einen Wechsel zu Enterprise oder Custom wenden Sie sich an Ihren Ansprechpartner bei HILLS Music. Wenn Sie noch kein Kunde sind, beantragen Sie API-Zugang. Sagen Sie uns, was Sie anbinden möchten und mit wie vielen Releases und Anfragen Sie ungefähr rechnen.
Was Sie erhalten
- API-Schlüssel. Eine Art von Schlüssel,
hm_live_…, mit eigenen Scopes und optionalem Ablaufdatum. Siehe Authentifizierung. - Einen Testweg, der nichts anlegt.
POST /ddex/validateund der SFTP-Ordner/testdurchlaufen jede Prüfung einer Auslieferung und antworten mit einem Bericht. Siehe Testordner. - DDEX-Auslieferung. Empfohlen ist ERN 4.3, ältere Versionen werden akzeptiert, per API oder SFTP. Siehe DDEX-Auslieferung.
- Webhooks. Bis zu 20 HTTPS-Endpunkte, signierte Events und automatische Wiederholungen. Siehe Webhooks.
- Den MCP-Server. Verbinden Sie KI-Assistenten mit Ihrem Workspace. Siehe unten.
Wer Schlüssel erstellen kann
Schlüssel werden auf der Seite Developers der HILLS Web-App erstellt. Der Kontoinhaber kann das immer. Ein Teammitglied kann es, wenn seine Rolle die Berechtigung für API-Schlüssel hat; diese legen Sie unter Settings → Team fest. Artists und Labels unter Ihrem Konto können keine Schlüssel erstellen: Die API gehört Ihnen, und jede Antwort umfasst Ihr Konto und die Artists und Labels darunter.
MCP-Server
Über den MCP-Server unter https://mcp.hillsmusic.com lesen KI-Assistenten Ihren Katalog, den Release-Status, Streams und Erlöse, Abrechnungen und Anfragen. Er bietet 10 rein lesende Tools. Die Anmeldung erfolgt mit dem eigenen HILLS-Konto über OAuth 2.1, ohne API-Schlüssel. Kundenkonten und ihre Teammitglieder können ihn verbinden; Teammitglieder brauchen die Rollenberechtigung, die beim jeweiligen Tool angegeben ist. Siehe MCP-Server.
Änderungen
API v1 ist stabil. Felder kommen mit der Zeit hinzu. Muss etwas wegfallen, wird es im Changelog mit einem Abschaltdatum angekündigt, und Antworten, die es verwenden, tragen bis dahin die Header Deprecation und Sunset. Siehe Anfragen senden.