Common error codes
Updated at：2025-11-03
When an error occurs during BLS access, the corresponding error code and message will be returned from BLS to help users identify and resolve the issue appropriately.
The format of the error message returned is as follows:
JSON
1{
2 "code":"Unauthorized",
3 "message":"Check unauthorized: invalid ak/sk",
4 "requestId":"bb32a6e2-fdb4-4b3e-8ff2-38ac14b24a18"
5}The table below lists common error codes that may appear in API responses. Error codes specific to individual APIs will be detailed in their respective API references.
| Error code | Error message | Description | HTTP status code |
|---|---|---|---|
| InvalidParameter | Request param invalid | Invalid request parameters | 400 |
| MalformedJSON | The JSON provided is not well-formed: {content} | Invalid json content format | 400 |
| Unauthorized | Unauthorized | Certification failed | 401 |
| AccessDenied | Access denied:{content} | Access denied | 403 |
| RequestOverload | Requested body too large, size exceed limit | Request body content too large | 413 |
| RequestLimited | Request frequency is too high, please slow down | Request frequency too high | 429 |
| InternalError | Internal server error | Internal service error | 500 |
| ServiceUnavailable | Service is unavailable | Service unavailable | 503 |