Membres
Vos artistes et labels : listez-les et invitez-en de nouveaux.
Vos artistes et labels : listez-les et invitez-en de nouveaux.
URL de base https://api.hillsmusic.com/v1. Chaque requête envoie une clé d’API : Authorization: Bearer hm_live_….
- Lister les artistes et labels
- Inviter un artiste ou un label
Lister les artistes et labels
GET /v1/members · Scope : members:read
Tous les artistes et labels rattachés à votre compte, du plus récent au plus ancien, avec le nombre de sorties de chacun.
Paramètres
| Paramètre | Emplacement | Type | Obligatoire | Description |
|---|---|---|---|---|
kind |
query | artist | label |
Non | Uniquement les artistes ou uniquement les labels. |
Exemple de requête
curl "https://api.hillsmusic.com/v1/members?kind=artist" \
-H "Authorization: Bearer $HILLS_API_KEY"
Réponse 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
}
]
}
Erreurs
| Statut | Quand |
|---|---|
| 400 | invalid : un paramètre est incorrect ; field l’indique. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired ou test_keys_retired. |
| 403 | insufficient_scope : la clé n’a pas le scope requis ; scope l’indique. account_inactive ou api_not_in_plan. |
| 429 | rate_limited : attendez le nombre de secondes indiqué par Retry-After. |
Inviter un artiste ou un label
POST /v1/members/invite · Scope : members:write
Crée le compte sous le vôtre et envoie par e-mail un lien (valable 7 jours) pour définir le mot de passe. 409 si un compte existe déjà avec cette adresse e-mail.
Corps de la requête
JSON.
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
email |
string | Oui | Son adresse e-mail. |
fname |
string | Oui | Prénom, ou nom du label. |
lname |
string | Non | Nom de famille. |
kind |
artist | label |
Oui | Artiste ou label. |
Exemple de requête
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"}'
Réponse 201
{
"ok": true,
"id": 57
}
Erreurs
| Statut | Quand |
|---|---|
| 400 | invalid : un paramètre est incorrect ; field l’indique. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired ou test_keys_retired. |
| 403 | insufficient_scope : la clé n’a pas le scope requis ; scope l’indique. account_inactive ou api_not_in_plan. |
| 409 | exists : un compte existe déjà avec cette adresse e-mail. |
| 429 | rate_limited : attendez le nombre de secondes indiqué par Retry-After. |