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