| 错误码 | 含义说明 |
|---|---|
| 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权限申请。 |
| 错误码 | 含义说明 |
|---|---|
| 6900 | 请求参数格式错误,具体参见返回信息中的msg字段。 |
| 6001 | 拉取code失败。 |
| 6081 | client_id非法。 |
| 6201 | 系统内部错误。 |
| 6202 | 系统内部错误。 |
| 6901 | client_id暂停使用。 |
| 6902 | app信息获取失败。 |
| 6903 | 获取API授权信息失败。 |
| 6904 | 执行API授权失败。 |
| 6905 | 参数redirect_uri无法解析出主域名。 |
| 6906 | 参数redirect_uri与注册域名不是同一个网站。 |
| 错误码 | 含义说明 |
|---|---|
| 7900 | 请求参数格式错误,具体参见返回信息中的msg字段。 |
| 7001 | 换取access token失败。 |
| 7016 | app secret长度非法。 |
| 7018 | 非法的app secret。 |
| 7019 | 非法的code。 |
| 7020 | code已过期。 |
| 7021 | code已经被用过。 |
| 7081 | client_id非法。 |
| 7201 | 系统内部错误。 |
| 7202 | 系统内部错误。 |
| 7901 | client_id暂停使用。 |
| 7902 | app信息获取失败。 |
| 7905 | 参数redirect_uri无法解析出主域名。 |
| 7906 | 参数redirect_uri与注册域名不是同一个网站。 |
| 错误码 | 含义说明 |
|---|---|
| 8900 | 请求参数格式错误,具体参见返回信息中的msg字段。 |
| 8064~8067 | 系统内部错误。 |
| 8081 | client_id非法。 |
| 8201 | 系统内部错误。 |
| 8202 | 系统内部错误。 |
| 8901 | client_id暂停使用。 |
| 8902 | app信息获取失败。 |
| 8903 | 获取API授权信息失败。 |
| 8904 | 执行API授权失败。 |
| 8905 | 参数redirect_uri无法解析出主域名。 |
| 8906 | 参数redirect_uri与注册域名不是同一个网站。 |
| 错误码 | 含义说明 |
|---|---|
| 9900 | 请求参数格式错误,具体参见返回信息中的msg字段。 |
| 9016 | access token无效。 |
| 9017 | access token已过期。 |
| 9018 | access token已废除。 |
| 9094 | access token非法。 |
| 9201 | 系统内部错误。 |
| 9202 | 系统内部错误。 |
| 错误码 | 含义说明 |
|---|---|
| 10001 | oauth_consumer_key(即appid)非法。 请根据请求临时token检查参数名及参数值是否正确。 |
| 10002 | oauth_signature_method非法。 请根据请求临时token检查参数名及参数值是否正确。 |
| 10003 | oauth_version非法。 请根据请求临时token检查参数名及参数值是否正确。 |
| 10004 | oauth_nonce非法。 请根据请求临时token检查参数名及参数值是否正确。 |
| 10005 | oauth_timestamp非法 。 请根据请求临时token检查参数名及参数值是否正确。 |
| 10006 | oauth_consumer_key(即appid)未注册 |
| 11000 | oauth_signature(签名值)错误,请注意检查参数名及参数值是否正确。 请按照签名参数oauth_signature的说明详细检查签名值的生成。 |
| 11001 | APP被禁用。 被禁用可能是由于违反了审核规范造成的。 |
| 12000 - 13000 | 系统内部错误。 |
| 错误码 | 含义说明 |
|---|---|
| 20001 | oauth_consumer_key(即appid)非法。 请根据请求已授权的临时token的请求参数说明检查参数名及参数值是否正确。 |
| 20002 | oauth_token(未授权的临时token)非法。 1、服务器时间错误,服务器时间与腾讯服务器时间相差不能超过10分钟。 |
| 20003 | oauth_callback非法,请注意检查是否与申请时提交的回调地址一致 |
| 20004 | oauth_consumer_key(即appid)未注册 |
| 21000 | 用户未登录 |
| 21001 | 用户未开通QQ空间 |
| 21002 | 获取用户授权信息失败 |
| 21003 | 获取APP信息失败 |
| 21004 | 非法的HTTP请求 |
| 21005 | APP被禁用。 被禁用可能是由于违反了审核规范造成的。 |
| 21006 | 请求的回调地址非法(没有传入域名,或者传入的域名与申请接入时填写的回调地址域名冲突)。 例如申请时填写的callback是:http://yoka.com,传入的是http://qzone.qq.com/get_access_token.php?a=b,则会返回错误码。 |
| 22000 - 23000 | 系统内部错误。 |
| 错误码 | 含义说明 |
|---|---|
| 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被禁用。 被禁用可能是由于违反了审核规范造成的。 |
| 32000 - 33000 | 系统内部错误。 |
| 错误码 | 含义说明 |
|---|---|
| 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权限的说明: |
| -4 | IP没有权限。nonhosting应用需排查是否对错误提示中的IP进行了授权。 |
| -5 | 签名参数sig校验失败。
(1)常见签名失败原因详见: |
| -6 | 访问频率超限 |
| -7 | 协议不合法(要求必须为https协议的地方,使用了http协议) |
| -8 | 请求受限,通常是安全审计没通过 |
| -9 | API不存在。 注意,出现该错误有可能有以下原因: |
| -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被禁用。 被禁用可能是由于违反了审核规范造成的。 |
| 42000 - 43000 | 系统内部错误。 |