Ir al contenido
HILLS API v1 Acceso anticipado

Referencia de la API

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.

¿Listo para integrar?

Solicita acceso a la API y te respondemos en 1 a 3 días hábiles.