nextX

Hướng dẫn

Gọi công cụ AI đọc dữ liệu bằng REST

Công cụ đọc của trợ lý AI (tra cứu, báo cáo) gọi được thẳng bằng API key, không cần máy chủ MCP. Hợp cho script, bảng tính, công cụ tự động.

  1. 1Tạo API key

    Khoá cần ít nhất một quyền của phân hệ có công cụ. Công cụ chạy với quyền của người tạo khoá: người đó không xem được gì thì khoá cũng không xem được.

    API key →

  2. 2Chọn công cụ

    Mở danh mục Công cụ AI, chọn phân hệ, xem tham số. Chỉ công cụ loại Đọc gọi được bằng REST.

    AI tools →

  3. 3Gọi

    Thân request là đúng các tham số của công cụ (không bọc trong args). Kết quả trả về là JSON của công cụ.

    curl
    curl -X POST https://api.nextx.vn/api/v1/ai/tools/crm/crm_appointments_query/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"op":"group","groupBy":"status"}'

    crm_appointments_query →

  4. 4Xử lý lỗi

    401 khoá sai hoặc đã thu hồi · 403 khoá thiếu quyền phân hệ · 404 không có công cụ · 429 vượt hạn mức, đọc Retry-After.

    Error codes →Rate limit →