公共返回码说明

移动应用接入时的公共返回码

错误码 含义说明
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过期,请重新走登录流程,根据使用Implicit_Grant方式获取Access_Token获取新的access token值。

100015 access token废除。

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操作的权限。请发送邮件进行申请接口权限
1 请求参数错误
2 用户没有开通对应的平台(朋友、空间、微博...)
1000 非法操作,通常是进行了不被授权的操作
1001 服务器繁忙,通常是后台出错

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

1002 用户没有登录态。原因可能有:1)用户没有到该平台注册(没有注册QQ空间,朋友,微博等);2)openkey过期。解决方案详见OpenAPI调用相关问题#7. 一直返回1002?
1003 账户被冻结

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

1004 账户余额不足
1005 用户没有开通腾讯朋友,请先到http://www.pengyou.com/ 开通腾讯朋友。
1006 用户没有开通QQ空间,请先到http://qzone.qq.com/ 开通QQ空间。
1100-1200 支付相关错误,预留码段,已经有的错误码说明如下,其他暂不可用:

1100:cdkey不存在;
1101:用户和cdkey不存在绑定关系,或礼品赠送完毕。
1102:参加活动受限。

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联系技术支持,调查问题原因并获得解决方案。

-71 openid和access_token不匹配,或openid和openkey不匹配,请检查参数access_token或openkey是否与openid匹配,并传入正确的值。

如果还有问题,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。

-73 此返回码表示用户修改了QQ密码,导致Access Token失效,需要引导用户重新登陆。
其它<= -50的返回码 都属于系统内部错误,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。

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

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部