tencent cloud

ドキュメントTencent WorkBuddy Enterprise

Common Error Codes

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-11-16 14:08:52
AI翻訳

1. Unified Response Structure Description

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
HTTP status codes
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)
Attention:
Business error codes are always included in the code field of the response body and are also exposed through the x-toa-biz-err response header.

2. Common Error Codes

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.

3. About 10030

All input parameter binding and validation failures are uniformly mapped to 10030, and the %s in the error description is populated with the specific field error.
Example: page_size is missing or out of range.
{
"code": 10030,
"msg": "Invalid page size: [pageSize]",
"trace_id": "..."
}

4. Gateway Error Codes

The following are gateway string-type error codes. They appear in gateway denial scenarios and are not included in the OpenAPI response body.
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

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック