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

Tham chiếu API

Trạng thái

Các trạng thái của một bản phát hành và của từng nền tảng, đúng như API trả về. status giữ cách gọi cũ trong một chu kỳ ngừng hỗ trợ.

Khi được duyệt, bản phát hành được phân phối ngay; một nền tảng hiển thị là đã lên kệ khi bản phát hành thực sự có mặt ở đó.

release_status

Code Ý nghĩa
draft Bản nháp: chưa gửi duyệt.
in_review Đang kiểm duyệt: đã gửi; đang chờ quyết định kiểm duyệt.
changes_requested Cần chỉnh sửa: đã trả lại cho nghệ sĩ kèm lý do; có thể sửa lại.
approved Đã duyệt: được phân phối ngay đến các nền tảng.
archived Đã lưu trữ: không được phân phối.
taken_down Đã gỡ: đã gỡ khỏi mọi nền tảng từng có bản phát hành.

delivery_state

Code Ý nghĩa
not_started Chưa bắt đầu: chưa gửi gì đến nền tảng nào.
delivering Đang phân phối: bản phát hành đang được gửi đến các nền tảng.
delivered Đã phân phối: mọi nền tảng đã nhận; chưa nền tảng nào hiển thị lên kệ.
partially_live Đã lên kệ một phần: đã lên kệ ở một số nền tảng; các nền tảng còn lại đã nhận hoặc đang nhận.
live Đã lên kệ: đã lên kệ ở mọi nền tảng được gửi đến.
needs_attention Cần xử lý: một nền tảng gặp lỗi, từ chối bản phát hành, hoặc đang chờ người xử lý (trang của nền tảng cho biết ai cần hành động).
taking_down Đang gỡ: yêu cầu gỡ đang được gửi đến các nền tảng.
taken_down Đã gỡ: đã gỡ khỏi mọi nền tảng từng có bản phát hành.

update_state

Code Ý nghĩa
none Mọi nền tảng đều có phiên bản được duyệt mới nhất.
pending Một phiên bản được duyệt mới hơn đang chờ gửi.
delivering Một phiên bản được duyệt mới hơn đang được gửi.

stores[key].status

Code Ý nghĩa
awaiting_approval Đang chờ duyệt (phase review)
queued Đang gửi (phase queue)
delivered Đã phân phối (phase done)
live Đã lên kệ (phase done)
failed Cần bạn sửa (phase attention)
takedown_queued Đã yêu cầu gỡ (phase takedown)
taken_down Đã gỡ (phase takedown)

status (ngừng hỗ trợ, bị gỡ bỏ vào 30/04/2027)

Code Ý nghĩa
draft release_status draft
pending release_status in_review
approved release_status approved, chưa lên kệ ở nền tảng nào
distributed release_status approved, đã lên kệ ở ít nhất một nền tảng
rejected release_status changes_requested
archived release_status archived hoặc taken_down

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.