公共返回码说明

目录

公共返回码-for OAuth2.0协议

100000-100031:PC网站接入时的公共返回码

错误码 含义说明
0 成功。
100000 缺少参数response_type或response_type非法。
100001 缺少参数client_id。
100002 缺少参数client_secret。
100003 http head中缺少Authorization。
100004 缺少参数grant_type或grant_type非法。
100005 缺少参数code。
100006 缺少refresh token。
100007 缺少access token。
100008 该appid不存在。
100009 client_secret(即appkey)非法。
100010 回调地址不合法,常见原因请见:回调地址常见问题及修改方法
100011 APP不处于上线状态。
100012 HTTP请求非post方式。
100013 access token非法。
100014 access token过期。

token过期时间为3个月。如果存储的access token过期,请重新走登录流程,根据使用Authorization_Code获取Access_Token使用Implicit_Grant方式获取Access_Token获取新的access token值。

100015 access token废除。

token被回收,或者被用户删除。请重新走登录流程,根据使用Authorization_Code获取Access_Token使用Implicit_Grant方式获取Access_Token获取新的access token值。

100016 access token验证失败。
100017 获取appid失败。
100018 获取code值失败。
100019 用code换取access token值失败。
100020 code被重复使用。
100021 获取access token值失败。
100022 获取refresh token值失败。
100023 获取app具有的权限列表失败。
100024 获取某OpenID对某appid的权限列表失败。
100025 获取全量api信息、全量分组信息。
100026 设置用户对某app授权api列表失败。
100027 设置用户对某app授权时间失败。
100028 缺少参数which。
100029 错误的http请求。
100030 用户没有对该api进行授权,或用户在腾讯侧删除了该api的权限。请用户重新走登录、授权流程,对该api进行授权。
100031 第三方应用没有对该api操作的权限。请发送邮件进行OpenAPI权限申请

6000-6999:WAP网站接入,获取Authorization Code时,发生错误

错误码 含义说明
6900 请求参数格式错误,具体参见返回信息中的msg字段。
6001 拉取code失败。
6081 client_id非法。
6201 系统内部错误。

请通过zx_qq.gif联系QQ登录支持人员,调查问题原因并获得解决方案。

6202 系统内部错误。

请通过zx_qq.gif联系QQ登录支持人员,调查问题原因并获得解决方案。

6901 client_id暂停使用。
6902 app信息获取失败。
6903 获取API授权信息失败。
6904 执行API授权失败。
6905 参数redirect_uri无法解析出主域名。
6906 参数redirect_uri与注册域名不是同一个网站。

7000-7999:WAP网站接入,通过Authorization Code获取Access Token时,发生错误

错误码 含义说明
7900 请求参数格式错误,具体参见返回信息中的msg字段。
7001 换取access token失败。
7016 app secret长度非法。
7018 非法的app secret。
7019 非法的code。
7020 code已过期。
7021 code已经被用过。
7081 client_id非法。
7201 系统内部错误。

请通过zx_qq.gif联系QQ登录支持人员,调查问题原因并获得解决方案。

7202 系统内部错误。

请通过zx_qq.gif联系QQ登录支持人员,调查问题原因并获得解决方案。

7901 client_id暂停使用。
7902 app信息获取失败。
7905 参数redirect_uri无法解析出主域名。
7906 参数redirect_uri与注册域名不是同一个网站。

8000-8999:WAP网站接入,通过Implicit模式获取Access Token时,发生错误

错误码 含义说明
8900 请求参数格式错误,具体参见返回信息中的msg字段。
8064~8067 系统内部错误。

请通过zx_qq.gif联系QQ登录支持人员,调查问题原因并获得解决方案。

8081 client_id非法。
8201 系统内部错误。

请通过zx_qq.gif联系QQ登录支持人员,调查问题原因并获得解决方案。

8202 系统内部错误。

请通过zx_qq.gif联系QQ登录支持人员,调查问题原因并获得解决方案。

8901 client_id暂停使用。
8902 app信息获取失败。
8903 获取API授权信息失败。
8904 执行API授权失败。
8905 参数redirect_uri无法解析出主域名。
8906 参数redirect_uri与注册域名不是同一个网站。

9000-9999:WAP网站接入,根据Access Token获得对应用户身份的openid时,发生错误

错误码 含义说明
9900 请求参数格式错误,具体参见返回信息中的msg字段。
9016 access token无效。
9017 access token已过期。
9018 access token已废除。
9094 access token非法。
9201 系统内部错误。

请通过zx_qq.gif联系QQ登录支持人员,调查问题原因并获得解决方案。

9202 系统内部错误。

请通过zx_qq.gif联系QQ登录支持人员,调查问题原因并获得解决方案。


公共返回码-for OAuth1.0协议(QQ互联已停止对OAuth1.0的支持,请及时进行接口升级)

10001-13000:请求临时token时,发生错误

错误码 含义说明
10001 oauth_consumer_key(即appid)非法。

请根据请求临时token检查参数名及参数值是否正确。

10002 oauth_signature_method非法。

请根据请求临时token检查参数名及参数值是否正确。

10003 oauth_version非法。

请根据请求临时token检查参数名及参数值是否正确。

10004 oauth_nonce非法。

请根据请求临时token检查参数名及参数值是否正确。

10005 oauth_timestamp非法 。

请根据请求临时token检查参数名及参数值是否正确。
该错误一般是由于服务器时间不同步引起的。注意第三方服务器时间与腾讯服务器时间相差不能超过5分钟。

10006 oauth_consumer_key(即appid)未注册
11000 oauth_signature(签名值)错误,请注意检查参数名及参数值是否正确。

请按照签名参数oauth_signature的说明详细检查签名值的生成。

11001 APP被禁用。

被禁用可能是由于违反了审核规范造成的。
请通过zx_qq.gif联系的QQ登录支持人员,获得最终解释。

12000 - 13000 系统内部错误。

请通过zx_qq.gif联系的QQ登录支持人员,调查问题原因并获得解决方案。

20001-23000:请求对临时token授权时,发生错误

错误码 含义说明
20001 oauth_consumer_key(即appid)非法。

请根据请求已授权的临时token的请求参数说明检查参数名及参数值是否正确。

20002 oauth_token(未授权的临时token)非法。

1、服务器时间错误,服务器时间与腾讯服务器时间相差不能超过10分钟。
2、oauth_token(未授权的临时token)非法。
请根据请求已授权的临时token的请求参数说明检查参数名及参数值是否正确。

20003 oauth_callback非法,请注意检查是否与申请时提交的回调地址一致
20004 oauth_consumer_key(即appid)未注册
21000 用户未登录
21001 用户未开通QQ空间
21002 获取用户授权信息失败
21003 获取APP信息失败
21004 非法的HTTP请求
21005 APP被禁用。

被禁用可能是由于违反了审核规范造成的。
请通过zx_qq.gif联系的QQ登录支持人员,获得最终解释。

21006 请求的回调地址非法(没有传入域名,或者传入的域名与申请接入时填写的回调地址域名冲突)。

例如申请时填写的callback是:http://yoka.com,传入的是http://qzone.qq.com/get_access_token.php?a=b,则会返回错误码。
正确的请求回调地址示例是:http://yoka.com?a=b&c=d

22000 - 23000 系统内部错误。

请通过zx_qq.gif联系的QQ登录支持人员,调查问题原因并获得解决方案。

30001-33000:请求具有Qzone访问权限的access_token时,发生错误

错误码 含义说明
30001 oauth_consumer_key(即appid)非法。

请根据请求access_token的请求参数说明检查参数名及参数值是否正确。

30002 oauth_signature_method非法。

请根据请求access_token的请求参数说明检查参数名及参数值是否正确。

30003 oauth_version非法。

请根据请求access_token的请求参数说明检查参数名及参数值是否正确。

30004 oauth_nonce非法。

请根据请求access_token的请求参数说明检查参数名及参数值是否正确。

30005 oauth_timestamp非法 ,请注意检查参数名及参数值是否正确。

该错误一般是由于服务器时间不同步引起的。注意第三方服务器时间与腾讯服务器时间相差不能超过5分钟。

30006 oauth_token(已授权的临时token)非法。

请根据请求access_token的请求参数说明检查参数名及参数值是否正确。

30007 oauth_vericode非法。

请根据请求access_token的请求参数说明检查参数名及参数值是否正确。

30008 oauth_consumer_key(即appid)未注册
31000 oauth_signature(签名值)错误,请注意检查参数名及参数值是否正确。

请按照签名参数oauth_signature的说明详细检查签名值的生成。

31001 oauth_token未被授权
31002 APP被禁用。

被禁用可能是由于违反了审核规范造成的。
请通过zx_qq.gif联系的QQ登录支持人员,获得最终解释。

32000 - 33000 系统内部错误。

请通过zx_qq.gif联系的QQ登录支持人员,调查问题原因并获得解决方案。

1000-1002,40001-43000:调用OpenAPI访问/修改Qzone资源时,发生错误

错误码 含义说明
1 请求参数错误
2 用户没有开通对应的平台(朋友、空间、微博...)
1000 调用该OpenAPI时私有参数错误。

请根据API列表中的接口输入参数说明来检查调用这个接口时传入的参数名及参数值是否正确。

1001 该OpenAPI服务繁忙
1002 没有登录态
1003 账户被冻结

(注:支付类OpenAPI提供了3级错误码,有一部分错误码的开头是1003,与这里的1003含义是不同的,详见支付联调说明#3. 支付错误码

1004 账户余额不足
1005 用户没有开通腾讯朋友,请先到http://www.pengyou.com/ 开通腾讯朋友。
1006 用户没有开通QQ空间,请先到http://qzone.qq.com/ 开通QQ空间。
1300 多区选服页面登录验证失败,原因:用户登录记录不存在,或登录已超时。
-1 请求参数无效。错误消息里会给出具体哪个参数不合法,不合法的原因可以参看接口说明中关于该参数的解释。
-2 请求中的appid不存在
-3 无API访问权限。

关于OpenAPI权限的说明:
(1)hosting应用创建后即自动分配出现在API列表中除支付接口以及试点接口外的其它所有接口权限。支付接口需申请接入支付后才分配权限,试点接口需按照该接口文档中的提示进行权限申请。
(2)non-hosting应用不能调用好友关系链OpenAPI。应用创建时默认分配v3/user/get_info接口权限;申请接入支付后分配支付接口权限;其余接口权限需申请开通(申请方式即将推出,推出前暂不接受申请)。

-4 IP没有权限。nonhosting应用需排查是否对错误提示中的IP进行了授权。
-5 签名参数sig校验失败。

(1)常见签名失败原因详见:
为什么总是返回“-5:signature verification failed”?
(2)开发者可以使用平台提供的签名验证工具来计算签名:http://open.qq.com/tools
(3)如果您是PHP开发者,可以使用PHP SDK中的签名生成函数来生成签名,避免自己去进行复杂的签名生成逻辑的开发。

-6 访问频率超限
-7 协议不合法(要求必须为https协议的地方,使用了http协议)
-8 请求受限,通常是安全审计没通过
-9 API不存在。

注意,出现该错误有可能有以下原因:
(1)开发者使用了错误的API名称,请仔细核对API说明中API的名称。
(2)开发者手动构造了pf参数,传入的pf与实际pf不符,导致报错(例如微博类接口,如果传入pf为空间或朋友,则会报该错)。
(3)系统内部错误。

-12 在测试环境中进行OpenAPI调试时,传入的是非调试者QQ号对应的OpenID ,将会返回本返回码,详见: 应用测试环境说明#3.2 测试OpenAPI
-20 应用调用的OpenAPI未经用户授权。
-21 access_token已废除,请重新获取access_token。
-22 openid不合法。注意校验规则详见概念和术语#2.1 OpenID
-23 openkey不合法。注意校验规则详见概念和术语#2.2 OpenKey
-24 openid或者openkey验证失败。注意校验规则详见概念和术语#2.1 OpenID
-58 OpenAPI的系统容错率为0.1%,如果应用后台调用OpenAPI报-58的频率占调用OpenAPI总次数的0.1%以下,是正常情况,请合理设置应用的容错与重试机制。

如果某个OpenAPI报错几率大于0.1%,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。

-60 OpenAPI的系统容错率为0.1%,如果应用后台调用OpenAPI报-60的频率占调用OpenAPI总次数的0.1%以下,是正常情况,请合理设置应用的容错与重试机制。

如果某个OpenAPI报错几率大于0.1%,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。

-65 OpenAPI的系统容错率为0.1%,如果应用后台调用OpenAPI报-65的频率占调用OpenAPI总次数的0.1%以下,是正常情况,请合理设置应用的容错与重试机制。

如果某个OpenAPI报错几率大于0.1%,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。

其它<= -50的返回码 都属于系统内部错误,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。
40001 oauth_consumer_key(appid)非法。

请根据OpenAPI请求参数说明检查参数名及参数值是否正确。

40002 oauth_signature_method非法。

请根据OpenAPI请求参数说明检查参数名及参数值是否正确。

40003 oauth_version非法。

请根据OpenAPI请求参数说明检查参数名及参数值是否正确。

40004 oauth_nonce非法。

请根据OpenAPI请求参数说明检查参数名及参数值是否正确。

40005 oauth_timestamp非法 ,请注意检查参数名及参数值是否正确。

该错误一般是由于服务器时间不同步引起的。注意第三方服务器时间与腾讯服务器时间相差不能超过5分钟。

40006 oauth_token(具有访问权限的access_token)非法。

请根据OpenAPI请求参数说明检查参数名及参数值是否正确。

40007 openid非法
40008 oauth_signature(签名值)格式错误或签名值缺失,请注意检查参数名及参数值是否正确。

请按照签名参数oauth_signature的说明详细检查签名值的生成。

40009 oauth_consumer_key(即appid)未注册
41000 oauth_signature(签名值)错误,请注意检查参数名及参数值是否正确。

请按照签名参数oauth_signature的说明详细检查签名值的生成。

41001 用户未授权
41002 错误的HTTP请求包
41003 access token失效。网站开发人员需要重新走整个OAuth流程,以获取新的access token。
41004 APP未被授权
41005 APP被禁用。

被禁用可能是由于违反了审核规范造成的。
请通过zx_qq.gif联系的QQ登录支持人员,获得最终解释。

42000 - 43000 系统内部错误。

请通过zx_qq.gif联系的QQ登录支持人员,调查问题原因并获得解决方案。


以上信息是否解决您的问题?

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部