Thành viên

Nghệ sĩ và hãng đĩa của bạn: liệt kê và mời thành viên mới.

Base URL https://api.hillsmusic.com/v1. Mọi request đều gửi một API key: Authorization: Bearer hm_live_….

• Liệt kê nghệ sĩ và hãng đĩa
• Mời nghệ sĩ hoặc hãng đĩa

Liệt kê nghệ sĩ và hãng đĩa

GET /v1/members · Scope: members:read

Mọi nghệ sĩ và hãng đĩa thuộc tài khoản của bạn, mới nhất trước, kèm số bản phát hành của mỗi người.

Parameter

Ví dụ request

curl "https://api.hillsmusic.com/v1/members?kind=artist" \
  -H "Authorization: Bearer $HILLS_API_KEY"

Phản hồi 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
    }
  ]
}

Lỗi

Mời nghệ sĩ hoặc hãng đĩa

POST /v1/members/invite · Scope: members:write

Tạo tài khoản thuộc tài khoản của bạn và gửi email cho họ một liên kết (hiệu lực 7 ngày) để đặt mật khẩu. 409 nếu email đã có tài khoản.

Body của request

JSON.

Ví dụ request

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"}'

Phản hồi 201

{
  "ok": true,
  "id": 57
}

Lỗi