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.
Cập nhật
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. 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. - Một đường kiểm thử không tạo ra gì.
POST /ddex/validatevà thư mục SFTP/testchạ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. - 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.
- Webhook. Tối đa 20 endpoint HTTPS, sự kiện có chữ ký và tự động gửi lại. Xem Webhook.
- 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.
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 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.