Error Codes
If a request error occurs, the server will return a JSON response containing the following parameters:
error_code: The error code.error_msg: A description of the error to help understand and resolve the issue.
For example, if the Access Token expires, the response will be:
{
"error_code": 110,
"error_msg": "Access token invalid or no longer valid"
}
Error Code Table
| Error Code | Error Message | Description |
|---|---|---|
| 0 | Unknown error | Unknown error. Please retry. If this error persists, contact the technical support team. |
| 3 | Unsupported openapi method | The requested API does not exist. Please check the request URL and try again. This error is often caused by non-English characters (e.g., "-") in the URL. Try manually inputting the correct URL. |
| 4 | Open API request limit reached | Cluster request limit exceeded. Please retry. If the error persists, contact the technical support team. |
| 6 | No permission to access data | No permission to access the API. |
| 17 | Open API daily request limit reached | Daily request limit exceeded. |
| 18 | Open API QPS request limit reached | QPS (queries per second) limit exceeded. |
| 19 | Open API total request limit reached | Total request limit exceeded. |
| 100 | Invalid parameter | Invalid access_token parameter. Token retrieval failed. Refer to the "Access Token Retrieval" documentation to obtain a new token. |
| 110 | Access token invalid or no longer valid | The access_token is invalid. |
| 111 | Access token expired | The access_token has expired. Its validity period is 30 days. Please ensure timely renewal or retrieve a new token with each request. |
| 216100 | Invalid param | The request contains illegal parameters. Please check and retry. |
| 216101 | Not enough param | A required parameter is missing. Please verify that all necessary parameters are included. |
| 216102 | Service not supported | The requested service is not supported. Please check the API URL. |
| 216103 | Param too long | Some parameters in the request are too long. Please check and retry. |
| 216110 | App ID does not exist | The appid does not exist. Please verify that it matches an app ID from your backend application list. |
| 216200 | Empty image | The image is empty. Please check and retry. |
| 216201 | Image format error | The uploaded image format is incorrect. Supported formats: PNG, JPG, JPEG, BMP. Please convert the image or use a different one. |
| 216202 | Image size error | The uploaded image size is incorrect. Refer to the API documentation for image size requirements and re-upload accordingly. |
| 216205 | Input oversize | The request body size is incorrect. The maximum allowed size (after base64 encoding) is 10MB. Please resend the request with a smaller input. |
| 216306 | Upload file error | File upload failed. Please check the request parameters for the file submission API. |
| 216308 | PDF file page number exceeds limit | The pdf_file_num parameter exceeds the actual number of pages in the PDF file. |
| 282161 | Driving license requests too frequently | Too many requests. This applies only to the driving license verification API. |
| 500110 | Unable to reach the API | Internal server error. Please contact the technical support team. |
| 500200 | Missing parameter | Internal server error. Please contact the technical support team. |