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

MCP server

delivery_status

Một lần phân phối DDEX theo id (từ list_deliveries): giai đoạn (queued → parsing → validating → importing → done / partial / failed), một mục cho mỗi bản…

Công cụ delivery_status · Chỉ đọc · Chỉ tài khoản khách hàng và nhóm của họ · Quyền vai trò: delivery.view

Một lần phân phối DDEX theo id (từ list_deliveries): giai đoạn (queued → parsing → validating → importing → done / partial / failed), một mục cho mỗi bản phát hành (được tạo, được cập nhật, gắn cờ chờ đội ngũ HILLS, bị bỏ qua) kèm release_id, và mọi lỗi kèm trường DDEX liên quan. Chỉ dành cho tài khoản khách hàng.

Tham số

Tham số Kiểu Bắt buộc Mô tả
id number Có Id của lần phân phối (từ POST /ddex hoặc lần commit).

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": "delivery_status",
    "arguments": {
      "id": 1
    }
  }
}

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ả
data 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.

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.