General Error Code
Last Updated:2020-10-21
When an error occurs when a user accesses the BLS service, BLS will return the corresponding error code and error message to the user, so that the user can locate the problem and make appropriate handling.
The format of the returned error message is as follows:
{
"code":"Unauthorized",
"message":"Check unauthorized: invalid ak/sk",
"requestId":"bb32a6e2-fdb4-4b3e-8ff2-38ac14b24a18"
}
The following table is the common error codes in API response, they may appear in API response. The error codes specific to each API will be described separately in the API reference.
Error code | Error message | Description | HTTP status code |
---|---|---|---|
InvalidParameter | Request param invalid | Illegal request parameter | 400 |
MalformedJSON | The JSON provided is not well-formed: {content} | json content format is invalid | 400 |
Unauthorized | Unauthorized | Authentication failed | 401 |
AccessDenied | Access denied:{content} | Access denied | 403 |
RequestOverload | Requested body too large, size exceed limit | The request body content is too large | 413 |
RequestLimited | Request frequency is too high, please slow down | Request frequency is too high | 429 |
InternalError | Internal server error | Internal service error | 500 |
ServiceUnavailable | Service is unavailable | Unavailable service | 503 |