Field | Type | Description |
code | int | Business error code. 0 indicates success. |
msg | string | Error message. Fixed to ok on success. |
trace_id | string | Unique request ID. Returned for every request. Provide it when locating issues. |
data | object / null | Business data |
Scenario | HTTP Status Code |
Business success | 200 |
Parameter validation failure (10030) | 400 |
Other business errors | Determined by error code mapping (for example, 201008 maps to 406) |
Error Code | HTTP Status Code | Description | Handling Recommendation |
0 | 200 | ok (success) | - |
10000 | 500 | Internal error | Retry. If the issue persists, submit a ticket. |
10001 | 401 | The user is not authorized. | access_token is missing, invalid, or expired. Re-obtain a credential. |
10030 | 400 | The parameter [%s] is invalid. | The request parameter is missing, has an invalid format, or is out of range. %s indicates the specific field name. |
10112 | 403 | You do not have the permission to access this resource. | The app has not enabled this API, or the contacts permission scope is insufficient. |
99906 | 429 | Requests are too frequent. | The API rate limiting is triggered. Reduce the call frequency and retry. |
10404 | 500 | RPC error | Failed to call the downstream service. Retry. |
10400 | 500 | MySQL write error | Server exception. Submit a ticket. |
10401 | 500 | MySQL read error | Server exception. Submit a ticket. |
{"code": 10030,"msg": "Invalid page size: [pageSize]","trace_id": "..."}
Error Code | HTTP | Description |
G40101 | 401 | token missing |
G40102 | 401 | token invalid |
G40103 | 401 | token expired |
G40104 | 401 | token mismatch |
G40301 | 403 | Permission denied |
G40303 | 403 | invalid API scope |
G42901 | 429 | too many requests |
G40401 | 404 | route not found |
G50000 | 500 | unknown internal server error |
フィードバック