release_status
Bản phát hành đang ở đâu: bản nháp, đang kiểm duyệt, đã duyệt, đã lên kệ hay bị từ chối (kèm lý do), và trạng thái phân phối trên từng nền tảng kèm liên…
Công cụ release_status · Chỉ đọc · Mọi tài khoản có quyền truy cập MCP · Quyền vai trò: releases.view
Bản phát hành đang ở đâu: bản nháp, đang kiểm duyệt, đã duyệt, đã lên kệ hay bị từ chối (kèm lý do), và trạng thái phân phối trên từng nền tảng kèm liên kết. Xác định bản phát hành bằng release_id (từ search_catalog), UPC, ISRC của một track hoặc tên. Nếu nhiều bản phát hành khớp, công cụ trả về danh sách để chọn.
Tham số
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
release_id |
integer | Không | |
upc |
string | Không | |
isrc |
string | Không | |
title |
string | Không | Tên bản phát hành (khớp một phần). |
Ví dụ lệnh gọi
Trợ lý AI thực hiện lệnh gọi này thay bạn; đây là nội dung được gửi đến https://mcp.hillsmusic.com qua JSON-RPC.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "release_status",
"arguments": {}
}
}Kết quả
Một dòng tóm tắt dạng văn bản, sau đó là cùng dữ liệu đó dạng JSON trong structuredContent, với các trường sau:
| Trường | Kiểu | Mô tả |
|---|---|---|
release |
object hoặc null | |
matches |
mảng object | |
tracks |
mảng object | |
stores |
mảng object | |
store_summary |
object |
Một lời từ chối (không có quyền, không tìm thấy, dữ liệu đầu vào sai) được trả về dưới dạng lỗi công cụ (isError: true), kèm văn bản giải thích lý do.