Chuyển đến nội dung
HILLS API v1

Tổng quan

HILLS API

API phân phối nhạc HILLS Music: đọc danh mục, trạng thái phân phối và doanh thu, gửi bản phát hành qua DDEX, nhận webhook và kết nối AI qua MCP.

Cập nhật

HILLS API kết nối hệ thống của riêng bạn với nền tảng HILLS Music. Các hãng đĩa, nhà phân phối và chủ sở hữu danh mục dùng API để đọc dữ liệu danh mục, phân phối và doanh thu bản quyền, và để gửi bản phát hành, thay vì chỉ làm việc trên trình duyệt.

API đã chạy chính thức và đi kèm các gói Enterprise và Custom. Xem Quyền truy cập và gói.

Bạn có thể xây dựng gì

  • Đồng bộ danh mục. Đọc mọi bản phát hành cùng các track, trạng thái kiểm duyệt và trạng thái trên từng nền tảng. Dùng updated_since để chỉ đồng bộ phần đã thay đổi.
  • Gửi bản phát hành qua DDEX. Gửi các lô ERN (khuyến nghị 4.3.2 hoặc 3.8.2) qua API hoặc SFTP. Mỗi bản phát hành trở thành một bản nháp trong danh mục của bạn rồi đi qua kiểm duyệt và phân phối đến các nền tảng. Hãy kiểm thử lô trước: không có gì được tạo ra.
  • Theo dõi phân phối. Theo dõi từng bản phát hành trên từng nền tảng, và nhận webhook khi bản phát hành được duyệt, lên kệ hoặc cần sửa.
  • Báo cáo. Đưa doanh thu theo tháng, bản phát hành hoặc nền tảng, số dư và các khoản thanh toán, cùng số liệu smart link vào công cụ BI hoặc kế toán của bạn.
  • Tiếp nhận nghệ sĩ. Liệt kê nghệ sĩ và hãng đĩa của bạn, và mời người mới.
  • Trợ lý AI. Kết nối Claude, ChatGPT và các trợ lý khác với không gian làm việc của bạn qua MCP server.

Bản phát hành chỉ vào HILLS dưới dạng DDEX ERN hoặc qua ứng dụng web. API không tạo hay sửa một bản phát hành theo từng trường, và không có endpoint tải lên riêng cho audio hay ảnh bìa: các tệp đi kèm bên trong lô DDEX.

Các thành phần
REST API https://api.hillsmusic.com/v1, JSON qua HTTPS, API key dạng Bearer. Bắt đầu với Bắt đầu nhanh.
DDEX POST /ddex/validate để kiểm thử, POST /ddex và tải lên trực tiếp để phân phối, cùng SFTP với hai thư mục /test và /production. Xem Phân phối DDEX.
Webhook Sự kiện có chữ ký cho bản phát hành, phân phối đến nền tảng, DDEX, sao kê, thanh toán, yêu cầu và hỗ trợ trực tuyến (Live support). Xem Webhook.
MCP server https://mcp.hillsmusic.com, 10 công cụ chỉ đọc, đăng nhập OAuth 2.1 bằng tài khoản HILLS của bạn. Xem MCP server.

Quyền truy cập hoạt động thế nào

Chỉ có một loại API key: hm_live_…. Chủ tài khoản, hoặc thành viên nhóm có quyền API keys, tạo key trên trang Developers của ứng dụng web HILLS. Mỗi key có scope riêng và thời hạn tùy chọn.

Không có sandbox riêng. Để thử một lần phân phối DDEX, hãy dùng chính key đó với POST /ddex/validate, hoặc thư mục SFTP /test. Cả hai đều chạy mọi bước kiểm tra và không tạo gì cả. Xem Thư mục test.

Tiếp theo

Sẵn sàng tích hợp?

Đăng ký quyền truy cập API, chúng tôi sẽ phản hồi bạn trong vòng 1–3 ngày làm việc.

Đăng ký quyền truy cập API So sánh các gói