Error Types
If you receive errorId
when making a request to the API, you can check the errorCode and errorDescription fields for more detailed error information.
{
"errorId": 1,
"errorCode": "errorCode",
"errorDescription": "errorDescription",
}
errorCode | errorDescription | Description |
---|---|---|
ERROR_SERVICE_UNAVALIABLE | Service is temporarily unavailable | Perhaps the server is under heavy load. Please try again later. If the issue persists, please contact customer service |
ERROR_REQUIRED_FIELDS | Please check the following fields: XXX | Missing or incorrect field. Please carefully check your input |
ERROR_THREADS_MAXIMUM | The recognition task has reached its maximum limit | When the number of concurrent requests exceeds the limit (1 concurrent request from task creation to recognition completion), this error will be prompted |
ERROR_PAGE_NOT_FOUND | The requested page does not exist | The requested path does not exist |
ERROR_BAD_REQUEST | Error in the request | An error occurred in the request. If the issue persists, please contact customer service |
ERROR_INTERNAL_SERVER_ERROR | Internal server error | If the issue persists, please contact customer service |
ERROR_IP_BANNED | Your IP address has been blocked for 10 minutes | If there are a large number of errors (reaching 1000 times) within a short period of time (1 minute), the system will automatically block for 30 minutes. Please check your error messages and retry |
ERROR_TASKID_INVALID | The task ID does not exist or has expired | The ID requested is incorrect or has already expired |
ERROR_TASK_TIMEOUT | The task has timed out | If the recognition process exceeds 120 seconds, a timeout error will be reported |
ERROR_SETTLEMENT_FAILED | Failure in task point settlement | Please check your balance or contact customer service |
ERROR_KEY_DOES_NOT_EXIST | Invalid account key | Please check whether your clientKey is correct. You can obtain it in the personal center |
ERROR_ZERO_BALANCE | Insufficient account balance | Insufficient account balance. Please recharge |
ERROR_NO_SUCH_METHOD | Unsupported request method | Only POST method is supported, and not the GET method |
ERROR_TASK_NOT_SUPPORTED | Unsupported task type | The captcha type is incorrect or not yet supported |
ERROR_CAPTCHA_UNSOLVABLE | Unable to recognize captcha | No charges will be deducted. Please retry |
ERROR_NO_SUCH_CAPCHA_ID | Captcha task has expired | No charges will be deducted. Please retry |
ERROR_RECAPTCHA_INVALID_SITEKEY | Invalid SITEKEY for target website | No charges will be deducted. If the SiteKey is confirmed to be correct, please retry |
ERROR_UNKNOWN_QUESTION | Incorrect question ID | Please check whether the question ID is correct |
ERROR_ILLEGAL_IMAGE | Image size does not meet the requirements | Please scale the image to the specified size: 450x450/300x300/100x100 |
ERROR_UNKNOW_450x450_QUESTION | This size is currently not supported for this question | The system may not be able to recognize images related to this question type. Please retry with other types of images |
ERROR_PARSE_IMAGE_FAIL | Failed to parse image | Please confirm whether the image BASE64 encoding is correct |
ERROR_IP_BLOCKED_5MIN | Due to too many error requests, access has been blocked | Due to too many error requests, access has been blocked. The system will automatically unblock after 5 minutes. Please refer to the development documentation for details on the automatic blocking mechanism |
ERROR_NO_SLOT_AVAILABLE | Insufficient server resources, please retry later | Please wait for 3 seconds before retrying. Do not send a large number of repeated requests within a short period of time, as it may trigger the automatic blocking mechanism |
ERROR_NO_SLOT_AVAILABLE_BLOCK | Insufficient server resources, please wait for 20 seconds and try again | If ERROR_NO_SLOT_AVAILABLE occurs more than 20 times within 1 minute, it will trigger automatic blocking. You will need to wait for 20 seconds before continuing to create tasks |