# 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.

<!-- Generated from openapi/hills-v1.json by scripts/api-reference.mjs. Edit the operation in hills-music (server/lib/ops), not this page. -->

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

<a id="list-artists-and-labels"></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

| Parameter | Vị trí | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- | --- |
| `kind` | query | `artist` \| `label` | Không | Chỉ nghệ sĩ hoặc chỉ hãng đĩa. |

### Ví dụ request

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

### Phản hồi `200`

```json
{
  "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ã trạng thái | Khi nào |
| --- | --- |
| 400 | invalid: một parameter bị sai; field cho biết parameter nào. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired hoặc test_keys_retired. |
| 403 | insufficient_scope: key thiếu scope; scope cho biết scope nào. account_inactive hoặc api_not_in_plan. |
| 429 | rate_limited: chờ số giây ghi trong Retry-After. |

<a id="invite-an-artist-or-label"></a>

## 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.

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `email` | string | Có | Địa chỉ email của họ. |
| `fname` | string | Có | Tên, hoặc tên hãng đĩa. |
| `lname` | string | Không | Họ. |
| `kind` | `artist` \| `label` | Có | Nghệ sĩ hay hãng đĩa. |

### Ví dụ request

```bash
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`

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

### Lỗi

| Mã trạng thái | Khi nào |
| --- | --- |
| 400 | invalid: một parameter bị sai; field cho biết parameter nào. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired hoặc test_keys_retired. |
| 403 | insufficient_scope: key thiếu scope; scope cho biết scope nào. account_inactive hoặc api_not_in_plan. |
| 409 | exists: đã có tài khoản với email này. |
| 429 | rate_limited: chờ số giây ghi trong Retry-After. |

Nguồn: https://developer.hillsmusic.com/vi/reference/members/