Zum Inhalt springen
HILLS API v1 Early Access

API-Referenz

Mitglieder

Ihre Artists und Labels: auflisten und neue einladen.

Ihre Artists und Labels: auflisten und neue einladen.

Basis-URL https://api.hillsmusic.com/v1. Jede Anfrage sendet einen API-Schlüssel: Authorization: Bearer hm_live_….

  • Artists und Labels auflisten
  • Artist oder Label einladen

Artists und Labels auflisten

GET /v1/members · Scope: members:read

Alle Artists und Labels unter Ihrem Konto, die neuesten zuerst, jeweils mit der Anzahl ihrer Releases.

Parameter

Parameter Ort Typ Pflicht Beschreibung
kind query artist | label Nein Nur Artists oder nur Labels.

Beispielanfrage

curl "https://api.hillsmusic.com/v1/members?kind=artist" \
  -H "Authorization: Bearer $HILLS_API_KEY"

Antwort 200

{
  "data": [
    {
      "id": 41,
      "email": "luna@example.com",
      "name": "Luna",
      "kind": "artist",
      "status": "active",
      "created_at": "2026-08-02T10:11:00Z",
      "last_login_at": null,
      "releases": 4
    }
  ]
}

Fehler

Status Wann
400 invalid: Ein Parameter ist fehlerhaft; field nennt ihn.
401 unauthenticated, invalid_key, key_revoked, key_expired oder test_keys_retired.
403 insufficient_scope: Dem Schlüssel fehlt der Scope; scope nennt ihn. account_inactive oder api_not_in_plan.
429 rate_limited: Retry-After Sekunden warten.

Artist oder Label einladen

POST /v1/members/invite · Scope: members:write

Legt das Konto unter Ihrem an und sendet per E-Mail einen Link (7 Tage gültig) zum Festlegen des Passworts. 409, wenn es für die E-Mail-Adresse bereits ein Konto gibt.

Request-Body

JSON.

Feld Typ Pflicht Beschreibung
email string Ja Die E-Mail-Adresse.
fname string Ja Vorname oder Name des Labels.
lname string Nein Nachname.
kind artist | label Ja Artist oder Label.

Beispielanfrage

curl -X POST "https://api.hillsmusic.com/v1/members/invite" \
  -H "Authorization: Bearer $HILLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"luna@example.com","fname":"Luna","kind":"artist"}'

Antwort 201

{
  "ok": true,
  "id": 57
}

Fehler

Status Wann
400 invalid: Ein Parameter ist fehlerhaft; field nennt ihn.
401 unauthenticated, invalid_key, key_revoked, key_expired oder test_keys_retired.
403 insufficient_scope: Dem Schlüssel fehlt der Scope; scope nennt ihn. account_inactive oder api_not_in_plan.
409 exists: Für diese E-Mail-Adresse gibt es bereits ein Konto.
429 rate_limited: Retry-After Sekunden warten.

Bereit für die Integration?

Beantragen Sie API-Zugang – wir melden uns innerhalb von 1–3 Werktagen bei Ihnen.