错误码含义说明
1请求参数错误
2用户没有开通对应的平台(朋友、空间、微博...)
1000调用该OpenAPI时私有参数错误。
请根据【QQ登录】API文档中的接口输入参数说明来检查调用这个接口时传入的参数名及参数值是否正确。
1001该OpenAPI服务繁忙
1002没有登录态
1003账户被冻结
(注:支付类OpenAPI提供了3级错误码,有一部分错误码的开头是1003,与这里的1003含义是不同的,详见支付联调说明#3. 支付错误码)
1004账户余额不足
1005
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接口权限;申请接入支付后分配支付接口权限;其余接口权限需申请开通(申请方式即将推出,推出前暂不接受申请)。
-4IP没有权限。nonhosting应用需排查是否对错误提示中的IP进行了授权。
-5签名参数sig校验失败。
(1)常见签名失败原因详见:
为什么总是返回“-5:signature verification failed”?
(2)开发者可以使用平台提供的签名验证工具来计算签名:http://open.qq.com/tools 。
(3)如果您是PHP开发者,可以使用PHP SDK中的签名生成函数来生成签名,避免自己去进行复杂的签名生成逻辑的开发。
-6访问频率超限
-7协议不合法(要求必须为https协议的地方,使用了http协议)
-8请求受限,通常是安全审计没通过
-9API不存在。
注意,出现该错误有可能有以下原因:
(1)开发者使用了错误的API名称,请仔细核对API说明中API的名称。
(2)开发者手动构造了pf参数,传入的pf与实际pf不符,导致报错(例如微博类接口,如果传入pf为空间或朋友,则会报该错)。
(3)系统内部错误。
-12在测试环境中进行OpenAPI调试时,传入的是非调试者QQ号对应的OpenID ,将会返回本返回码,详见: 应用测试环境说明#3.2 测试OpenAPI。
-20应用调用的OpenAPI未经用户授权。
-21access_token已废除,请重新获取access_token。
-22openid不合法。注意校验规则详见概念和术语#2.1 OpenID。
-23openkey不合法。注意校验规则详见概念和术语#2.2 OpenKey。
-24openid或者openkey验证失败。注意校验规则详见概念和术语#2.1 OpenID。
-58OpenAPI的系统容错率为0.1%,如果应用后台调用OpenAPI报-58的频率占调用OpenAPI总次数的0.1%以下,是正常情况,请合理设置应用的容错与重试机制。
如果某个OpenAPI报错几率大于0.1%,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。
-60OpenAPI的系统容错率为0.1%,如果应用后台调用OpenAPI报-60的频率占调用OpenAPI总次数的0.1%以下,是正常情况,请合理设置应用的容错与重试机制。
如果某个OpenAPI报错几率大于0.1%,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。
-65OpenAPI的系统容错率为0.1%,如果应用后台调用OpenAPI报-65的频率占调用OpenAPI总次数的0.1%以下,是正常情况,请合理设置应用的容错与重试机制。
如果某个OpenAPI报错几率大于0.1%,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。
其它<= -50的返回码都属于系统内部错误,请通过企业QQ联系技术支持,调查问题原因并获得解决方案。
40001oauth_consumer_key(appid)非法。
请根据OpenAPI请求参数说明检查参数名及参数值是否正确。
40002oauth_signature_method非法。
请根据OpenAPI请求参数说明检查参数名及参数值是否正确。
40003oauth_version非法。
请根据OpenAPI请求参数说明检查参数名及参数值是否正确。
40004oauth_nonce非法。
请根据OpenAPI请求参数说明检查参数名及参数值是否正确。
40005oauth_timestamp非法 ,请注意检查参数名及参数值是否正确。
该错误一般是由于服务器时间不同步引起的。注意第三方服务器时间与腾讯服务器时间相差不能超过5分钟。
40006oauth_token(具有访问权限的access_token)非法。
请根据OpenAPI请求参数说明检查参数名及参数值是否正确。
40007openid非法
40008oauth_signature(签名值)格式错误或签名值缺失,请注意检查参数名及参数值是否正确。
40009oauth_consumer_key(即appid)未注册
41000oauth_signature(签名值)错误,请注意检查参数名及参数值是否正确。
41001用户未授权
41002错误的HTTP请求包
41003access token失效。网站开发人员需要重新走整个OAuth流程,以获取新的access token。
41004APP未被授权
41005APP被禁用。
被禁用可能是由于违反了【QQ登录】接入规范造成的。
请通过企业QQ联系的QQ登录支持人员,获得最终解释。
42000 - 43000系统内部错误。
请通过企业QQ联系的QQ登录支持人员,调查问题原因并获得解决方案。