Miembros
Tus artistas y sellos: consúltalos e invita a otros nuevos.
Tus artistas y sellos: consúltalos e invita a otros nuevos.
URL base https://api.hillsmusic.com/v1. Cada solicitud envía una clave de API: Authorization: Bearer hm_live_….
- Listar artistas y sellos
- Invitar a un artista o sello
Listar artistas y sellos
GET /v1/members · Ámbito: members:read
Todos los artistas y sellos de tu cuenta, del más reciente al más antiguo, con el número de lanzamientos de cada uno.
Parámetros
| Parámetro | Ubicación | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
kind |
query | artist | label |
No | Solo artistas o solo sellos. |
Ejemplo de solicitud
curl "https://api.hillsmusic.com/v1/members?kind=artist" \
-H "Authorization: Bearer $HILLS_API_KEY"
Respuesta 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
}
]
}
Errores
| Estado | Cuándo |
|---|---|
| 400 | invalid: un parámetro es incorrecto; field indica cuál. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired o test_keys_retired. |
| 403 | insufficient_scope: a la clave le falta el ámbito; scope indica cuál. account_inactive o api_not_in_plan. |
| 429 | rate_limited: espera los segundos que indique Retry-After. |
Invitar a un artista o sello
POST /v1/members/invite · Ámbito: members:write
Crea la cuenta dentro de la tuya y le envía por correo un enlace (válido 7 días) para establecer su contraseña. 409 si el correo ya tiene una cuenta.
Cuerpo de la solicitud
JSON.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
email |
string | Sí | Su dirección de correo electrónico. |
fname |
string | Sí | Nombre de pila o nombre del sello. |
lname |
string | No | Apellidos. |
kind |
artist | label |
Sí | Qué tipo de cuenta es. |
Ejemplo de solicitud
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"}'
Respuesta 201
{
"ok": true,
"id": 57
}
Errores
| Estado | Cuándo |
|---|---|
| 400 | invalid: un parámetro es incorrecto; field indica cuál. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired o test_keys_retired. |
| 403 | insufficient_scope: a la clave le falta el ámbito; scope indica cuál. account_inactive o api_not_in_plan. |
| 409 | exists: ya hay una cuenta con este correo. |
| 429 | rate_limited: espera los segundos que indique Retry-After. |