# Quyền truy cập và gói

> HILLS API, webhook và MCP đi kèm các gói Enterprise và Custom. Ai được tạo key, rate limit là bao nhiêu và cách đăng ký quyền truy cập.

HILLS API đã chạy chính thức cho các tài khoản khách hàng dùng gói Enterprise và Custom.

## Các gói

| | Enterprise | Custom |
| --- | --- | --- |
| REST API và DDEX qua API | Có | Có |
| Webhook | Có | Có |
| Số request mỗi phút, cho mỗi key | 120 | Đặt theo khối lượng của bạn (600 nếu không có thỏa thuận khác) |

Ở các gói khác, key không hoạt động và trả về `403 api_not_in_plan`, đồng thời không thể thêm endpoint webhook. Nếu bạn chuyển xuống gói thấp hơn, các key hiện có sẽ ngừng hoạt động cho đến khi gói của bạn lại bao gồm API. Không có gì bị xóa. Bạn vẫn có thể kiểm thử tệp DDEX trên trang DDEX của ứng dụng web và trong thư mục SFTP `/test`.

Để chuyển sang Enterprise hoặc Custom, hãy trao đổi với người phụ trách của bạn tại HILLS Music. Nếu bạn chưa là khách hàng, hãy [đăng ký quyền truy cập API](https://hillsmusic.com/apply/?type=api). Cho chúng tôi biết bạn muốn kết nối những gì, cùng số lượng bản phát hành và request mà bạn dự kiến.

## Bạn nhận được gì

- **API key.** Một loại key duy nhất, `hm_live_…`, với scope riêng và thời hạn tùy chọn. Xem [Xác thực](https://developer.hillsmusic.com/vi/guides/authentication/).
- **Một đường kiểm thử không tạo ra gì.** `POST /ddex/validate` và thư mục SFTP `/test` chạy mọi bước kiểm tra như một lần phân phối thật và trả về báo cáo. Xem [Thư mục test](https://developer.hillsmusic.com/vi/reference/test-folder/).
- **Phân phối DDEX.** Khuyến nghị ERN 4.3.2 hoặc 3.8.2, vẫn nhận các phiên bản cũ hơn, qua API hoặc SFTP. Xem [Phân phối DDEX](https://developer.hillsmusic.com/vi/guides/ddex/).
- **Webhook.** Tối đa 20 endpoint HTTPS, sự kiện có chữ ký và tự động gửi lại. Xem [Webhook](https://developer.hillsmusic.com/vi/guides/webhooks/).
- **MCP server.** Kết nối trợ lý AI với không gian làm việc của bạn. Xem bên dưới.

## Ai được tạo key

Key được tạo trên trang **Developers** của ứng dụng web HILLS. Chủ tài khoản luôn tạo được key. Thành viên nhóm tạo được nếu vai trò của họ có quyền API keys, thiết lập trong **Settings → Team**. Nghệ sĩ và hãng đĩa thuộc tài khoản của bạn không tạo được key: API là của bạn, và mọi phản hồi đều bao gồm tài khoản của bạn cùng các nghệ sĩ và hãng đĩa thuộc tài khoản đó.

## MCP server

MCP server tại `https://mcp.hillsmusic.com` cho phép trợ lý AI đọc danh mục, trạng thái bản phát hành, lượt nghe và doanh thu, sao kê và các yêu cầu của bạn. Server có 10 công cụ chỉ đọc. Người dùng đăng nhập bằng tài khoản HILLS của chính mình qua OAuth 2.1, không cần API key. Tài khoản khách hàng và thành viên nhóm của họ có thể kết nối, và thành viên nhóm cần quyền vai trò mà mỗi công cụ yêu cầu. Xem [MCP server](https://developer.hillsmusic.com/vi/mcp/overview/).

## Thay đổi

API v1 đã ổn định. Các trường mới được bổ sung dần theo thời gian. Khi cần bỏ một thứ gì đó, việc này được thông báo trong [nhật ký thay đổi](https://developer.hillsmusic.com/vi/changelog/) kèm ngày ngừng hỗ trợ, và cho đến ngày đó, các phản hồi có dùng đến nó sẽ mang header `Deprecation` và `Sunset`. Xem [Gửi request](https://developer.hillsmusic.com/vi/guides/making-requests/#versioning).

Nguồn: https://developer.hillsmusic.com/vi/overview/early-access/