... 2022-10-14 大约 1 分钟
# 1. 如何排查问题？
【前置准备】
为了方便定位问题和反馈问题，建议开发者在自己的程序或脚本中打印完整的 Request 和 Response 信息。
【问题定位】
通过查看请求的响应体来判断请求是否成功，请求的响应体中包含了 ret 和 msg 两个字段，分别代表请求返回码 和 请求状态描述。一般情况下，通过这两个信息就可以判断请求是否成功以及错误的原因是什么。
请求成功示例：
{'ret': 0, 'msg': 'Succeed'}
1
1
请求失败示例：
# 请求失败，原因：请求参数不合法，校验不通过
{'ret':10002, msg:'Input parameter verification failed'}
1
2
2
1
2
2
不同错误码的含义解释详见：常见错误码
如果上述方式不能解决您的问题，请参考下方的 如何反馈问题
# 2. 如何反馈问题？
当接口返回 Server-Side Error 类型的报错时，可以到 反馈平台 (opens new window) 反馈问题，我们会有人工客服为您排查。
为了加快您的问题被解答的进度，建议您采用以下格式进行提问。
【请求内容】
- url： docs.qq.com/XXX/XXX?param1=xxx¶m2=xxxx
- request header:
Access-Token: xxxxxxxxxx
Client-Id: xxxxxxxxxx
Open-Id: xxxxxxxxxx
- request body: {json string}
【错误信息】
- traceID: xxxxxxxxxxxxx
- response body: {json string}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
traceID： 请求的流水号。通过回包 header 的 X-Trace-Id 字段返回给调用者。