HTTP Status Codes
Linkbest API uses standard HTTP status codes to represent the results of API requests. The corresponding status codes are explained 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 | No valid ADS_KEY provided. |
| 403 | FORBIDDEN | The API key used does not have permission to perform the request. |
| 404 | NOT FOUND | The requested resource does not exist. |
| 405 | METHOD NOT ALLOWED | The method used in the call is not supported. |
| 429 | TOO MANY REQUESTS | The API requests are too frequent. It is recommended to reduce the request rate. |
| 500 502 503 504 | SERVER ERROR | There was an issue with the Linkbest server. (This situation 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 indicate the reason 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 | Successful response |
| 4000 | Validation error, please check the parameters |
| 4001 | Insufficient resources |
| 5001 | Network busy |