Nhà Phát Triển

XBuddy cung cấp REST API tại https://api.xbuddy.co/api/v1. Mọi endpoint yêu cầu xác thực bằng JWT Bearer token.

Trong mục này

• Xác Thực — lấy và làm mới JWT token
• Cổng AI — gọi các năng lực AI của XBuddy qua API
• Nhật Ký Thay Đổi — các thay đổi và tính năng mới theo thời gian

Base URL

https://api.xbuddy.co/api/v1

Giới hạn tần suất (rate limit)

Định dạng response

Mọi response theo cấu trúc:

{
  "success": true,
  "data": { ... },
  "message": "Operation completed"
}

Response có phân trang:

{
  "success": true,
  "data": [ ... ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 243,
    "pages": 5
  }
}

Response lỗi

{
  "success": false,
  "error": "Unauthorized",
  "statusCode": 401
}

Mã trạng thái thường gặp:

• 200 — OK
• 201 — Created
• 400 — Bad Request (lỗi validation)
• 401 — Unauthorized
• 403 — Forbidden (vượt quota hoặc module chưa kích hoạt)
• 404 — Not Found
• 429 — Vượt giới hạn tần suất