Bỏ qua tới nội dung

Tìm thao táccatalog_search

Search the operation catalog

Chỉ đọcHồ sơ: Lõi (luôn có)Quyền: Không cần quyền

Find operations by words across the whole catalog, including tools not in your current profiles, and see which profile and permission each needs.

Không thay đổi gì.

REST

GET
/api/public/v2/catalog

MCP

catalog_search

Cùng tên trên cổng đăng nhập /mcp và cổng khoá /api/public/mcp.

Tham số

TênỞ đâuKiểuBắt buộcMô tả
qquerystringKhôngMặc định "". Tối đa 100 ký tự.
profilequerystringKhôngTối đa 40 ký tự.
limitqueryintegerKhôngMặc định 20. Từ 1 tới 100.

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?q=&profile=%E2%80%A6&limit=20" \
  -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

HTTPcodeÝ nghĩa
401unauthorizedThiếu khoá/đăng nhập, hoặc khoá không đúng.
422validation_failedDữ liệu gửi lên sai kiểu hoặc thiếu trường — xem `violations`.
429rate_limitedQuá 60 yêu cầu/phút cho một khoá hoặc kết nối — đợi theo Retry-After.
503pausedAPI/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_search",
    "arguments": {
      "q": "",
      "profile": "…",
      "limit": 20
    }
  }
}