Chỉ đọcHồ sơ: Lõi (luôn có)Quyền: Không cần quyền
Full description, input JSON Schema, REST route, permission, risk and confirmation rule of one operation.
Không thay đổi gì.
REST
GET
/api/public/v2/catalog/{opId}MCP
catalog_describeCùng tên trên cổng đăng nhập /mcp và cổng khoá /api/public/mcp.
Tham số
| Tên | Ở đâu | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
opId | đường dẫn | string | Bắt buộc | Tối đa 64 ký tự. |
Không gửi workspaceId: luôn lấy từ khoá hoặc kết nối AI.
curl -X GET "https://<ten-mien-cua-ban>/api/public/v2/catalog/3f2c1e9b-6a4d-4c0f-b2e8-3d7a9f1c2e44" \
-H "Authorization: Bearer $WA_AUTO_KEY"Phản hồi (200)
{
"…": "dữ liệu của thao tác"
}Lỗi có thể gặp
| HTTP | code | Ý nghĩa |
|---|---|---|
| 401 | unauthorized | Thiếu khoá/đăng nhập, hoặc khoá không đúng. |
| 404 | not_found | Không có đối tượng này, hoặc bạn không được xem nó. |
| 422 | validation_failed | Dữ liệu gửi lên sai kiểu hoặc thiếu trường — xem `violations`. |
| 429 | rate_limited | Quá 60 yêu cầu/phút cho một khoá hoặc kết nối — đợi theo Retry-After. |
| 503 | paused | API/MCP đang tạm dừng (nút ngắt khẩn của workspace hoặc đội vận hành). |
Lỗi theo RFC 9457 (application/problem+json). Xem mọi mã lỗi.
# MCP (JSON-RPC) — tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "catalog_describe",
"arguments": {
"opId": "3f2c1e9b-6a4d-4c0f-b2e8-3d7a9f1c2e44"
}
}
}