Aller au contenu
API HILLS v1 Accès anticipé

Référence API

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.

Prêt à vous intégrer ?

Demandez l’accès à l’API : nous vous répondons sous 1–3 business days.