HTTP Status Codes
Linkbest API uses standard HTTP status codes to represent the results of API requests. The corresponding status code explanations are as follows:
| Code | Response Message | Description |
|---|---|---|
| 200 201 | OK | Everything is working as expected. |
| 400 | BAD REQUEST | The request is not acceptable, usually due to missing required parameters. |
| 401 | UNAUTHORIZED | ADS_KEY is not provided or is invalid. |
| 403 | FORBIDDEN | The request is not allowed due to lack of permission. |
| 404 | NOT FOUND | The requested resource does not exist. |
| 405 | METHOD NOT ALLOWED | The method used in the request is not supported. |
| 429 | TOO MANY REQUESTS | The API requests are being made too frequently. It is recommended to reduce the request rate. |
| 500 502 503 504 | SERVER ERROR | There is an issue with the Linkbest server. (This is rare.) |
API Business Service Error Codes
Even when the HTTP status code is 200, the API request may fail due to various reasons such as parameter errors, missing data, insufficient balance, etc. Linkbest provides the following error codes to explain the reasons for the error. You can handle the errors accordingly based on the following error codes.
Although business service errors are rare, we recommend writing code that can gracefully handle all possible API exceptions.
| Error Code | Description |
|---|---|
| 200 | Normal response |
| 4000 | Validation error, please check the parameters |
| 4001 | Operation data does not exist |
| 4002 | Insufficient resources, such as balance |
| 4003 | No permission to operate on the corresponding data |
| 5001 | Network busy |