Dokumentation

Anleitungen

Schnellstart, Authentifizierung, Anfragen, Fehler, Limits, Paginierung, Webhooks und DDEX-Auslieferung.

• Schnellstart API-Schlüssel in der HILLS Web-App erstellen, mit /me prüfen, dann Releases auflisten und Erlöse lesen. In etwa fünf Minuten.
• Authentifizierung API-Schlüssel (hm_live_) als Bearer-Token senden: Schlüssel erstellen, Scopes und Ablauf wählen, rotieren, widerrufen – und was Auth-Fehler bedeuten.
• Anfragen senden Basis-URL, JSON-Format von Anfragen und Antworten, Response-Header, Versionierung und Abkündigungen – und was Sie dem Support senden, wenn etwas hakt.
• Fehler Das Fehlerformat, alle Status und Codes, die die API zurückgibt, welche Fehler Sie wiederholen sollten, und ein Node-Fehlerhandler zum Übernehmen.
• Rate Limits Anfragen pro Minute und API-Schlüssel in jedem Tarif, die X-RateLimit-Header, wie eine 429 aussieht und wie Sie per Backoff unter dem Limit bleiben.
• Paginierung Releases mit cursor und next_cursor seitenweise lesen, Webhook-Zustellungen mit before und has_more, und nur synchronisieren, was sich geändert hat.
• Webhooks Events von HILLS Music an Ihrem HTTPS-Endpunkt: Abonnieren, die 13 Eventtypen, der Umschlag, X-Hills-Signature prüfen, Wiederholungen und Protokoll.
• DDEX-Auslieferung Releases als DDEX ERN senden: Batch mit POST /ddex/validate testen, mit POST /ddex oder Direkt-Uploads liefern, SFTP nutzen und den Lieferbericht lesen.