Khắc phục sự cố

API, thông điệp CLI và CI

Ý nghĩa của các thông báo về gói và giới hạn từ Mokxi API, công cụ dòng lệnh và GitHub Action.

Những gì bạn thấy

CLI in ra lỗi dạng mokxi: <message> (<code>, <request id>). API trả về cùng thông điệp và mã đó trong câu trả lời JSON. Mã trong ngoặc là tiêu đề bên dưới. Hãy gửi kèm request id khi bạn viết thư cho chúng tôi.

How each tool works is in Mokxi API, the command line tool and CI; tiện ích mở rộng VS Code nằm trong GitHub và VS Code.

Số phút mô phỏng (quota_exceeded)

"Bạn đã dùng hết N phút mô phỏng mà gói của bạn có trong tháng này." Thời gian mô phỏng chạy qua API được tính vào mức hằng tháng: 100 phút trên gói Free, 2.000 trên gói Pro, Student, Teacher và Classroom, và 5.000 trên gói Ultra (không còn bán; các tài khoản có sẵn vẫn giữ nguyên). Trên gói Teacher và Classroom, giáo viên và lớp học của họ dùng chung một mức, nên thông điệp có thể ghi là "lớp học của bạn" thay vì vậy. Số đếm bắt đầu lại vào ngày đầu tháng (UTC), được nêu trong thông điệp. Một lần chạy đã bắt đầu dưới mức giới hạn luôn chạy xong, và không bao giờ phải trả thêm phí khi vượt mức. Mạch chạy trong trình soạn thảo không bao giờ bị tính.

Quá nhiều yêu cầu (rate_limited)

  • "Gói của bạn cho phép N yêu cầu mỗi phút cho mỗi token" hoặc "N lần mô phỏng mỗi giờ cho mỗi token". 60 yêu cầu mỗi phút và 30 lần mô phỏng mỗi giờ trên gói Free, 600 cho mỗi loại trên các gói trả phí. Hãy đợi số giây mà header Retry-After đưa ra.
  • "Quá nhiều yêu cầu không kèm token; hãy gửi kèm một token cho mức giới hạn của gói của bạn."
  • "Thời lượng là X ms; gói của bạn chạy tối đa N ms thời gian mô phỏng mỗi yêu cầu." 10 giây thời gian mô phỏng mỗi lần chạy trên gói Free, 60 trên các gói trả phí. Hãy chia một lần chạy dài thành các lần chạy ngắn hơn.

Token (unauthorized, insufficient_scope, token_limit)

  • "Send your token as "Authorization: Bearer mkx_..."", "that token is not valid", "was revoked" or "has expired". Make a new token on API tokens in Cài đặt, hoặc đăng nhập lại bằng mokxi login.
  • "Token này không có phạm vi ..." Hãy tạo một token có tick phạm vi đó: simulate để chạy mô phỏng, projects:read và projects:write cho dự án.
  • "Gói của bạn giữ được N token API cùng lúc; hãy thu hồi một token trước." 5 trên gói Free, 25 trên các gói trả phí.
  • "Mã đó không rõ hoặc đã hết hạn; hãy bắt đầu lại" (mokxi login). Chạy lại phần đăng nhập và phê duyệt mã mới trong vòng vài phút.

Cần có gói (license_required)

  • "Mokxi cho VS Code là một phần của gói Pro." Bắt đầu dùng thử Pro miễn phí 7 ngày, hoặc chọn Pro tại /pricing.
  • "Mokxi CI miễn phí cho kho lưu trữ công khai." Các lần chạy từ GitHub Action, hoặc từ CLI trong một job CI, trên kho lưu trữ riêng tư cần một token CI từ tài khoản Pro (đặt nó thành MOKXI_TOKEN, hoặc input token của Action). CI cho kho lưu trữ riêng tư đi kèm gói Pro, giá học sinh, gói Lifetime, Classroom và bản dùng thử, và với Ultra cho các tài khoản vẫn còn giữ nó. Chạy một sketch trên máy của bạn bằng mokxi run vẫn miễn phí, không cần tài khoản.
  • "... You can keep using it until then." (December 11, 2026) A notice, not an error: accounts that used VS Code or CI before the change keep it until that date.

Vẫn chưa giải quyết được

Hãy viết thư cho chúng tôi từ trang /support kèm nguyên văn thông điệp và request id.