# Tra cứu mã lỗi

`errorId` luôn là `0` hoặc `1`. Chuỗi `errorCode` là hợp đồng giao thức và **không** được dịch.

| errorCode | Khi nào | Mô tả | Thao tác máy khách |
|---|---|---|---|
| `ERROR_KEY_DOES_NOT_EXIST` | — | clientKey không hợp lệ hoặc không tồn tại | Kiểm tra khóa trong cổng người dùng; không thử lại với cùng giá trị. |
| `ERROR_ZERO_BALANCE` | — | Không đủ số dư tài khoản | Dừng tạo tác vụ; mua điểm. Khả dụng = số dư − đóng băng. |
| `ERROR_TASK_NOT_SUPPORTED` | — | Loại tác vụ không được hỗ trợ | Kiểm tra chuỗi loại và loại đó có đang bật không. Loại bị tắt cũng trả về mã này. |
| `ERROR_TASK_NOT_ACTIVE` | — | Loại tác vụ không hoạt động | Được liệt kê để tương thích. Bản chương trình hiện tại không trả về mã này: loại không hoạt động bị xóa khỏi registry. |
| `ERROR_TASK_DENIED` | — | Từ chối tạo tác vụ | Tài khoản bị chặn. Hãy liên hệ hỗ trợ. |
| `ERROR_RATE_LIMIT` | — | Vượt giới hạn tốc độ | Giãn thời gian thử lại; cửa sổ giới hạn tính riêng cho từng khóa API. |
| `ERROR_NO_SLOT_AVAILABLE` | — | Không có vị trí xử lý khả dụng | Thử lại sau. Cũng dùng khi phiên Akamai đang bận. |
| `CAPTCHA_NOT_READY` | — | Kết quả tác vụ chưa sẵn sàng | Tiếp tục truy vấn getTaskResult mỗi 1–2 giây. |
| `ERROR_CAPTCHA_UNSOLVABLE` | — | Không giải được captcha | Không liên tục tạo lại tác vụ tính phí mà chưa kiểm tra; hãy kiểm tra trang và tham số. |
| `ERROR_BAD_REQUEST` | — | Yêu cầu sai định dạng | Sửa trường bị thiếu, kiểu dữ liệu, URL/base64 hoặc thời gian chờ. |
| `ERROR_INTERNAL` | — | Lỗi máy chủ nội bộ | Thử lại với thời gian chờ tăng dần; liên hệ hỗ trợ nếu lỗi tiếp diễn. |
| `ERROR_TASK_NOT_FOUND` | — | Không tìm thấy tác vụ | taskId sai hoặc thuộc khóa khác. |
| `ERROR_TASK_EXPIRED` | — | Tác vụ đã hết hạn | Tạo tác vụ mới. Cũng dùng khi phiên trình duyệt Akamai hết hạn. |
| `ERROR_TOO_MANY_REQUESTS` | — | Quá nhiều lần truy vấn kết quả | Dừng truy vấn taskId này, giới hạn 120 lần. |

Source: https://kaptra.ai/vi/docs/error-codes/error-dictionary