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

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](https://hillsmusic.com/apply/?type=api). 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](https://developer.hillsmusic.com/de/guides/authentication/).
- **Einen Testweg, der nichts anlegt.** `POST /ddex/validate` und der SFTP-Ordner `/test` durchlaufen jede Prüfung einer Auslieferung und antworten mit einem Bericht. Siehe [Testordner](https://developer.hillsmusic.com/de/reference/test-folder/).
- **DDEX-Auslieferung.** Empfohlen ist ERN 4.3, ältere Versionen werden akzeptiert, per API oder SFTP. Siehe [DDEX-Auslieferung](https://developer.hillsmusic.com/de/guides/ddex/).
- **Webhooks.** Bis zu 20 HTTPS-Endpunkte, signierte Events und automatische Wiederholungen. Siehe [Webhooks](https://developer.hillsmusic.com/de/guides/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](https://developer.hillsmusic.com/de/mcp/overview/).

## Änderungen

API v1 ist stabil. Felder kommen mit der Zeit hinzu. Muss etwas wegfallen, wird es im [Changelog](https://developer.hillsmusic.com/de/changelog/) mit einem Abschaltdatum angekündigt, und Antworten, die es verwenden, tragen bis dahin die Header `Deprecation` und `Sunset`. Siehe [Anfragen senden](https://developer.hillsmusic.com/de/guides/making-requests/#versioning).

Quelle: https://developer.hillsmusic.com/de/overview/early-access/