# 錯誤碼字典

`errorId` 一律為 `0` 或 `1`。`errorCode` 字串屬於介面契約，**不予翻譯**。

| errorCode | 發生時機 | 說明 | 用戶端處理方式 |
| --- | --- | --- | --- |
| `ERROR_KEY_DOES_NOT_EXIST` | — | clientKey 無效或不存在 | 請在使用者門戶核對金鑰，不要使用相同的值重試。 |
| `ERROR_ZERO_BALANCE` | — | 帳戶餘額不足 | 停止建立任務並購買點數。可用餘額 = balance − frozen。 |
| `ERROR_TASK_NOT_SUPPORTED` | — | 不支援此任務類型 | 檢查類型字串及該類型是否已啟用。停用的類型也會傳回此錯誤碼。 |
| `ERROR_TASK_NOT_ACTIVE` | — | 此任務類型未啟用 | 為相容性而列出。目前的執行檔不會傳回此錯誤碼，因為未啟用的類型會從註冊表移除。 |
| `ERROR_TASK_DENIED` | — | 任務建立遭拒 | 帳戶已遭封禁，請聯絡支援。 |
| `ERROR_RATE_LIMIT` | — | 超出速率限制 | 請延遲重試；限制期間按各 API 金鑰分別計算。 |
| `ERROR_NO_SLOT_AVAILABLE` | — | 沒有可用的處理位置 | 請稍後重試。Akamai 工作階段忙碌時也會使用此錯誤碼。 |
| `CAPTCHA_NOT_READY` | — | 任務結果尚未就緒 | 繼續每 1–2 秒輪詢 getTaskResult。 |
| `ERROR_CAPTCHA_UNSOLVABLE` | — | 無法求解驗證碼 | 不要盲目重試而產生費用，請檢查網站和參數。 |
| `ERROR_BAD_REQUEST` | — | 請求格式錯誤 | 修正缺少的欄位、類型、URL/base64 或逾時設定。 |
| `ERROR_INTERNAL` | — | 伺服器內部錯誤 | 請延遲重試；若持續發生，請聯絡支援。 |
| `ERROR_TASK_NOT_FOUND` | — | 找不到任務 | taskId 錯誤，或任務屬於其他金鑰。 |
| `ERROR_TASK_EXPIRED` | — | 任務已過期 | 請建立新任務。Akamai 瀏覽器工作階段過期時也會使用此錯誤碼。 |
| `ERROR_TOO_MANY_REQUESTS` | — | 結果查詢次數過多 | 停止輪詢此 taskId，最多可查詢 120 次。 |

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