Error Codes
A non-zero code in the response means the request failed. The tables below list all common error codes. Some APIs have their own business codes, documented in the corresponding API pages.
Common error codes
| Code | Description |
|---|
| 0 | Success |
| 1000 | Invalid request parameters; check required fields and formats |
| 1001 | Missing authentication info; no App ID / App Key found |
| 1002 | Invalid App ID |
| 1003 | Wrong App Key |
| 1004 | Application disabled; contact support |
| 1005 | API not purchased or package exhausted; purchase or renew and retry |
| 1009 | API not found; check the spelling of the API code |
| 1010 | Deduction failed; insufficient balance or billing error |
| 1011 | Internal server error; retry later or report with request_id |
Business error codes
| Code | Description |
|---|
| 1100 | ID card verification failed (mismatch or upstream error) |
| 1200 | Failed to initiate Alipay verification |
| 1201 | Failed to query Alipay verification result |
Troubleshooting tips
Make sure X-APP-ID and X-APP-KEY are sent and match the values in the console
Confirm the corresponding API package is purchased and has remaining quota
Keep the request_id from the response and attach it when reporting issues — it speeds up diagnosis significantly