1 概述
1、MSDK错误码分为接入层、逻辑层、平台层.
2、普通的错误，比如appid错误、appkey错误、权限控制等由接入层直接返回，具体错误含义参考msdk接入层错误码.
3、逻辑层出现错误时，MSDK接入层会透传错误码ret、错误描述msg，其中ret由MSDK逻辑层定义.
4、如果涉及到平台层的业务错误，手Qtoken侧错误MSDK会返回ret：-10000，msg为：平台错误码,平台错误描述，如："msg":"-73,the user modify password wrong".
5、如果涉及到平台层的业务错误，微信侧错误MSDK会返回ret：-20000，msg为：平台错误码,平台错误描述，如："msg":"40001,invalid credential"
6、MSDK接入层已对错误码进行了分类处理，新增参数err_type，0:正常，1:网络不稳定，请稍后再试，2：重新授权,3:用refreshToken刷新acessToken,5:未知错误
2 MSDK接入层错误码
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| 0 | 成功 | |
| -303 | 该appid在msdk没有权限 | 确认appid是否正确；确认该业务基本资料审核是否已经通过；确认该业务是否有该接口权限。 |
| -304 | 请求参数不是json格式 | 请使用json格式请求 |
| -307 | 内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -308 | 内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -309 | 内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -310 | 内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -311 | 逻辑层找不到对应的接口命令字 | msdk逻辑层未实现该功能，请联系MSDK客服提供技术支持。 |
| -312 | 内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -402 | 用户反馈功能缺少参数 | 检查请求参数是否正确 |
| -501 | http请求中，body为空 | 请求串中http body不能为空，请参考接口文档请求样例 |
| -502 | msdk接入层url 签名错误 | 签名计算方式为sig=md5(appkey + timestamp) |
| -503 | 频率超限 | 同一个用户请求频率超过限制 |
| -504 | appid不存在 | url中appid为空或该app没有该接口访问权限，请联系MSDK客服提供技术支持。 |
| -505 | url 错误，接口不存在 | 接口不存在，确认接口名称 |
| -506 | url 缺少参数 | 对照接口文档检查参数 |
| -507 | 内部错误，不用处理 | 正常错误，不用处理 |
| -601 | 内部错误 | 重试一次，若一直失败请联系MSDK客服提供技术支持。 |
| -701 | 内部错误 | 重试一次，若一直失败请联系MSDK客服提供技术支持。 |
| -702 | 内部错误 | 重试一次，若一直失败请联系MSDK客服提供技术支持。 |
| -801 | 用户反馈相关错误 | 重试一次，若一直失败请联系MSDK客服提供技术支持。（不影响游戏正常功能） |
| -901 | 游客模式下，不能访问该接口 | 切换成手Q、微信登录模式下 |
| -107 | 支付IP不在白名单中 | 重试一次，若一直失败请联系MSDK客服提供技术支持。 |
| -101 | 解析http失败 | 重试一次，若一直失败请联系MSDK客服提供技术支持。 |
3 MSDK逻辑层错误码
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| 0 | 成功 | |
| 1 | 查询结果为空，没数据 | 不需要处理 |
| -100 | -100到-999为系统级错误 | |
| -101 | msdk逻辑层内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -102 | msdk逻辑层内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -103 | msdk逻辑层内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -104 | msdk逻辑层内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -105 | msdk逻辑层内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -106 | msdk逻辑层内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -109 | 游客模式执行失败 | 请检查appid、appkey、accessToken、guestid准确性 |
| -110 | 游客模式校验失败 | 请检查appid、appkey、accessToken、guestid准确性 |
| -1000 | -1000到-1999为客户端返回的错误 | |
| -1011 | 输入参数为空 | 检查请求body中参数是否为空或int/string类型错误 |
| -2000 | -2000~-9999以下为服务器返回的错误 | |
| -2001 | 内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -2002 | 内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -2003 | 命令不存在 | msdk逻辑层未提供该接口 |
| -2004 | msdk逻辑层收到的平台响应包错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -2005 | msdk逻辑层收到的平台http body为空 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -2006 | msdk逻辑层收到的平台响应包json解析失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -2007 | msdk逻辑层收到的平台响应包返回值为空 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -2008 | 内部错误（ST解码失败） | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -2009 | 内部错误（A8解码失败） | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -2010 | 内部错误（配置文件中找不到该业务该业务配置或配置错误） | 确认该业务基本资料审核是否已经通过；若失败请联系MSDK客服提供技术支持。 |
| -10000 | -10000以上为业务本身的错误 | 请参看msg中具体错误描述 |
| -10001 | 非法的qq号 | 必须要大于10000才是合法的号码 |
| -10002 | 非法的openid | 请确认传入的appid、openid是否正确，若还有疑问请联系MSDK客服提供技术支持。 |
| -10003 | 错误的登录方式 | 请确认是手Q（1）、微信（2）、游客模式（5）中的一种 |
| -10005 | 内部异常 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -10010 | 白名单数据已经存在 | 正常返回，该用户已抢过号，不需要再抢。 |
| -10011 | 白名单数据已满 | 白名单总数据已达到上限，提示用户稍后再来抢号（扩大白名单上限后） |
| -10012 | 没有对应数据 | 该用户不在白名单列表中，需要抢号才能进入游戏 |
| -10013 | 没有对应的权限配置 | 确认该业务基本资料审核是否已经通过；若失败请联系MSDK客服提供技术支持。 |
| -10014 | 记录已过期 | 该用户白名单数据已过期，需要重新抢号 |
| -10015 | no user auth；玩家未授权“获取QQ/微信好友关系” | 核对拉起授权页面时是否同意授权“获取QQ/微信好友关系” |
| -15000 | -15000~-19999为手Q平台OIDB相关的业务错误 | 具体请看http://wiki.msdk.qq.com/Router/errorcode.html#oidb_errcode |
| -20000 | -20000以上为微信业务错误 | 请参看msg中具体错误描述 |
| -20001 | 非法的QQ号 | 必须要大于10000才是合法的号码 |
| -20002 | 非法的openid | 请确认传入的appid、openid是否正确，若还有疑问请联系MSDK客服提供技术支持。 |
| -20003 | 错误的登录方式 | 请确认是手Q（1）、微信（2）、游客模式（5）中的一种 |
| -20004 | 非法的appid | 确认appid是否正确 |
| -20005 | 内部异常 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -30000 | -30000及以上为LBS错误 | |
| -30001 | LBS位置信息失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -30005 | 获取附近的人失败 |
4 手Q平台错误码
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| -1 | client的请求参数无效 | 检查请求参数准确性 |
| -2 | 请求中的appid不存在 | 确认appid、appkey的准确性，若失败请联系MSDK客服提供技术支持。 |
| -3 | client请求中app到api访问无权限 | 确认该appid是否有权限，如有权限的话请联系MSDK客服提供技术支持。 |
| -4 | 请求中的app ip不允许 | 若失败请联系MSDK客服提供技术支持。 |
| -5 | 签名验证失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -6 | client请求中app到api访问超限 | 降低访问频率，检查是否正常请求，若失败请联系MSDK客服提供技术支持。 |
| -7 | 请求协议非法 eg https 搞成了http | 确认访问协议是否正确，若失败请联系MSDK客服提供技术支持。 |
| -8 | 请求受限,通常是安全审计没通过 | 若失败请联系MSDK客服提供技术支持。 |
| -9 | api不存在 | 若失败请联系MSDK客服提供技术支持。 |
| -10 | 请求中的app 内网ip不允许 | 若失败请联系MSDK客服提供技术支持。 |
| -11 | 请求中的app 外网ip不允许 | 若失败请联系MSDK客服提供技术支持。 |
| -12 | 测试环境调试号码受限 | 请使用有权限的号码 |
| -20 | client请求中api未经用户授权 | 重新授权 |
| -21 | access_token已废除 | 重新授权 |
| -22 | openid非法 | 确认appid、openid的准确性，若失败请联系MSDK客服提供技术支持。 |
| -23 | openkey非法 | 重新授权 |
| -24 | openid openkey验证失败 | 重新授权 |
| -25 | 0x71f 0x5b:timestamp与系统当前时间相差超过10分钟 | 确认appid、appkey、openkey的一致性，若失败请联系MSDK客服提供技术支持。 |
| -26 | 0x71f 0x5a: 重复的nonce | openid转换时出错，确认appid、openid准确性 |
| -70 | 登录验证返回，验证openkey时appid非法 | 确认appid、appkey、openkey的一致性，若失败请联系MSDK客服提供技术支持。 |
| -71 | openid和openkey不匹配 | 确认openid与openkey的一致性 |
| -72 | appkey和权限tmem中的appkey不一致 | 确认appid、appkey的准确性，若失败请联系MSDK客服提供技术支持。 |
| -73 | 0x47 access token改密失效 | 重新授权 |
| 100000 | 缺少或错误response_type | 请检查请求参数 |
| 100001 | 缺少参数client_id | 请检查请求参数 |
| 100002 | 缺少参数client_secret | 请检查请求参数 |
| 100003 | http head中缺少Authorization | 请检查请求参数 |
| 100004 | 缺少或错误grant_type | 请检查请求参数 |
| 100005 | 缺少code参数 | 请检查请求参数 |
| 100006 | 缺少refresh token | 请检查请求参数 |
| 100007 | 缺少access token | 请检查请求参数 |
| 100008 | 该appid不存在 | 确认appid的准确性，若失败请联系MSDK客服提供技术支持。 |
| 100009 | appkey(client_secret) 不合法 | 确认appid、appkey的准确性，若失败请联系MSDK客服提供技术支持。 |
| 100010 | 回调地址不合法 | 回调地址不合法，常见原因请见： http:wiki.open.qq.com/wiki/faq/website /%E5%9B%9E%E8%B0%83%E5%9C%B0%E5%9D%80%E5%B8 %B8%E8%A7%81%E9%97%AE%E9%A2%98%E5%8F%8A%E4%BF%AE %E6%94%B9%E6%96%B9%E6%B3%95 |
| 100011 | APP不处于上线状态 | 若失败请联系MSDK客服提供技术支持。 |
| 100012 | 非post方式 | 若失败请联系MSDK客服提供技术支持。 |
| 100013 | access token不合法 | 重新授权 |
| 100014 | access token过期 | 重新授权 |
| 100015 | access token废除 | 重新授权 |
| 100016 | access token验证失败，其它原因 | 重新授权 |
| 100030 | no user auth玩家未授权“获取QQ好友关系” | 拉起授权页面，核对是否打开“获取QQ好友关系”开关 |
| 251001 | 参数非法 | 按照参数列表检查参数是否正确 |
| 251002 | access token不合法 | 重新授权 |
| 251003 | 获取好友openid失败 | 接口调用无权限，请申请权限 |
| 251004 | 获取好友缓存失败 | 反馈到MSDK联系手Q侧处理 |
| 251005 | 更新好友缓存失败 | 反馈到MSDK联系手Q侧处理 |
5 微信平台错误码
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| 0 | ok | - |
| -1 | system error | 重试一次，若一直失败请联系MSDK客服提供技术支持。 |
| -6 | 包名或者签名不正确 | 检查包名或者签名是否正确 |
| 10026 | BundleID不正确 | 请使用和平台侧配置一致的BundleID |
| 40001 | invalid credential | 重新拉起授权 |
| 40002 | invalid grant_type | 重新拉起授权 |
| 40003 | invalid openid | 确认openid准确性，若还有问题，联系msdk反馈给微信侧处理 |
| 40007 | invalid media_id | 上传图片使用的media_id无效，重新上传图片获取media_id |
| 40008 | invalid message type | - |
| 40009 | invalid image size | 检查图片大小是否在要求范围内 |
| 40012 | invalid thumb size | 检查缩略图大小是否在要求范围内 |
| 40013 | invalid appid | 确认appid准确性，若还有问题，联系msdk反馈给微信侧处理 |
| 40014 | invalid access_token | 确认access_token准确性，若还有问题，联系msdk反馈给微信侧处理 |
| 40029 | invalid code | 重新拉起授权 |
| 40030 | invalid refresh_token | 重新拉起授权 |
| 40031 | invalid openid list | 重新拉起授权 |
| 40032 | invalid refresh_token | 重新拉起授权 |
| 40036 | invalid template_id size | - |
| 40037 | invalid template_id | - |
| 40039 | invalid url size | 检查url长度是否在要求范围内 |
| 40066 | invalid url | 检查url是否合法 |
| 40097 | invalid args | 接收方屏蔽了消息，让接收方查看一下微信：发现->游戏->我->隐私设置->游戏管理中查看“接收游戏消息”是否设置为关闭状态 |
| 40163 | code been used | 重新拉起授权 |
| 40180 | invalid client tmp token | 重新拉起授权 |
| 41001 | access_token missing | 重新拉起授权 |
| 41002 | appid missing | 确认请求参数appid准确性，若失败请联系MSDK客服提供技术支持。 |
| 41003 | refresh_token missing | 确认请求参数appid、refresh_token准确性，若失败请联系MSDK客服提供技术支持。 |
| 41004 | appsecret missing | 确认请求参数appid、appkey准确性，若失败请联系MSDK客服提供技术支持。 |
| 41006 | media_id missing | 检查media_id参数是否传递 |
| 41008 | missing code | 确认请求参数code准确性，若失败请联系MSDK客服提供技术支持。 |
| 41009 | missing openid | 确认请求参数appid、openid准确性，若失败请联系MSDK客服提供技术支持。 |
| 41010 | missing url | 检查url参数是否传递 |
| 42001 | access_token expired | accessToken过期，刷新token或重新拉起授权 |
| 42003 | code expired | 重新拉起授权 |
| 42004 | refresh_token expired | 重新拉起授权 |
| 42009 | client tmp token expired | 重新拉起授权 |
| 43003 | require https | 使用https请求 |
| 43004 | require subscribe | - |
| 43005 | require friend relations | - |
| 44002 | empty post data | - |
| 45003 | title size out of limit | 检查title参数是否超过限制 |
| 45004 | description size out of limit | 检查description参数是否超过限制 |
| 45005 | url size out of limit | 检查url参数长度是否超过限制 |
| 45009 | api freq out of limit | 限制访问频率，检查是否受攻击，若失败请联系MSDK客服提供技术支持。 |
| 45011 | api limit | 限制访问频率，检查是否受攻击，若失败请联系MSDK客服提供技术支持。 |
| 45013 | too many template args | 限制访问频率，检查是否受攻击，若失败请联系MSDK客服提供技术支持。 |
| 45014 | template message size out of limit | 限制访问频率，检查是否受攻击，若失败请联系MSDK客服提供技术支持。 |
| 47001 | data format error | - |
| 48001 | api unauthorized | 查看是否具有接口权限或者微信客户端“授权管理”处的应用“朋友关系”开关是否开启 |
5.1 微信加绑群错误码
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| -1 | 系统错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -10000 | 内部错误 | 游戏没有在开平开通创建群的权限。 |
| -10001 | 该游戏没有建群权限 | 游戏没有在游戏中心开通创建群的权限。 |
| -10002 | 参数检查错误 | 确认参数准确性，若失败请联系MSDK客服提供技术支持。 |
| -10003 | 链接不存在（与群无关） | |
| -10004 | 获取跳转链接失败（与群无关） | |
| -10005 | 群ID已存在 | 不要重复建群 |
| -10007 | 群ID不存在 | 换一个存在的群ID |
| -10008 | 群ID不可用 | |
| -10009 | 用户不在群里 | |
| -10010 | 加群数量达到上限 | |
| -20001 | 解绑群达到上限 | 解绑群不能超过20个 |
| -20002 | 用户创建群达到上限 | |
| -201608 | kv读失败 | 联系微信相关接口人员 |
| -201609 | kv写失败 | 联系微信相关接口人员 |
5.2 手Q群接口错误码
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| 221001 | 工会已有绑定群 | 更换群或者工会 |
| 221002 | 未绑定群 | 先进行绑群，再进行此操作 |
| 221003 | 绑群回包错误 | 联系手Q群svr同学处理 |
| 221004 | 获取uin和tskey失败 | 检查登录态是否正确 |
| 221005 | 当前用户不是群主 | 检查当前用户是否为群主 |
| 221006 | 无效的openid | 检查openid是否有效 |
| 221007 | 传入参数不对 | 检查接口参数，如appid,guild_id,zone_id,gc等等，具体请参考接口参数列表 |
| 221008 | 无接口调用权限 | 参照权限管理申请权限 |
| 221009 | 不是工会成员 | 检查玩家身份是否是工会成员 |
| 221010 | 达到创建群上限 | 联系手Q群svr同学处理 |
| 221011 | 创建群频率过高 | 联系手Q群svr同学处理 |
| 221012 | 群被删除了 | 联系手Q群svr同学处理 |
| 221013 | 群平台接口异常 | 联系手Q群svr同学处理 |
| 221014 | 读取存储失败 | 联系手Q群svr同学处理 |
| 221015 | 写入存储失败 | 联系手Q群svr同学处理 |
| 221016 | 发送公众号消息失败 | 联系手Q群svr同学处理 |
| 221017 | 数据上报失败 | 联系手Q群svr同学处理 |
| 221018 | 提醒绑群过于频繁 | 降低绑群接口访问频率 |
| 221019 | 群已经绑定了其他工会 | 更换群或者工会，再进行绑定 |
| 221020 | 群是收费群 | 更换绑定群为非收费群 |
| 221021 | 非游戏群 | 更换绑定群为游戏群 |
| -182001 | 请求群后台cgi失败 | 联系群平台同学处理 |
| -182002 | 操作cmem失败 | 联系手Q群svr同学处理 |
| -182003 | 创建群失败 | 联系群平台同学处理 |
| -182004 | 查询群失败 | 联系群平台同学处理 |
| -182005 | openid转uin失败 | 联系群平台同学处理 |
| -182006 | 加群失败 | 联系群平台同学处理 |
| -182007 | 查询群列表失败 | 联系手Q群svr同学处理 |
| -182008 | 查询idip失败 | 联系手Q群svr同学处理 |
| -500003~-500009 | 解析服务返回数据失败 | 联系手Q群svr同学处理 |
| -120000 | 登录态校验失败 | 检查登录态是否有效 |
6 手Q游戏中心错误码
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| 0 | 成功 | |
| -4000 | 创建处理逻辑失败 | 重试一次 |
| -4001 | 参数缺失 | 检查输入参数准确性，若失败请联系MSDK客服提供技术支持。 |
| -4002 | 解析sid失败 | 重试一次 |
| -4003 | 写小红点时间戳失败 | 重试一次 |
| -4004 | 参数缺失 | 检查输入参数准确性，若失败请联系MSDK客服提供技术支持。 |
| -4005 | servlet服务没有创建处理逻辑 | 重试一次 |
| -4006 | 必须参数缺失 | 检查输入参数准确性，若失败请联系MSDK客服提供技术支持。 |
| -4007 | 拉取应用好友失败 | 重试一次 |
| -4008 | 验证AccessToken失败 | 重试一次 |
| -4009 | 频率限制超过 | 降低频率，若失败请联系MSDK客服提供技术支持。 |
| -4010 | 获取UIN错误 | 确认appid、openid、accessToken准确性，大部分原因是accessToken过期了，accessToken是有有效期的，若失败请联系MSDK客服提供技术支持。 |
| -4011 | 获取open id错误 | 确认appid、openid准确性，若失败请联系MSDK客服提供技术支持。 |
| -4012 | 上报成就数据过期，只有比原来数据大才可上报 | 过期时间戳无效 |
| -4013 | 效验skey失败 | 重新授权 |
| -4014 | 没有设置如何效验用户身份 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4015 | 没有找到合适的uri | 确认appid、接口名称准确性，若失败请联系MSDK客服提供技术支持。 |
| -4016 | 请求参数sig效验错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4017 | openid不存在 | 确认appid、openid准确性，若还有错误，联系msdk反馈给游戏中心开发 |
| -4018 | 服务异常 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4019 | 拉取成就数据失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4020 | 发feeds失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4021 | 获取个人信息失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4022 | 参数不合法 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4023 | 获取feeds失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4024 | 没有最近玩的游戏 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4025 | 获取最近玩的游戏失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4026 | 应用在db里无配置 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4027 | 拉取feeds失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4028 | 解析json失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4029 | 会员上报挑战开始信息失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4030 | 游戏上报挑战开始信息失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4031 | 时间戳非法,起始要小于结束 | 过期时间戳无效 |
| -4032 | appid校验失败 | 确认appid准确性，若失败请联系MSDK客服提供技术支持。 |
| -4033 | URL中无param字段或字段不合法 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4034 | json中无list字段或字段不合法 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| -4035 | json中无type或无data字段,或字段不合法(data不能留空) | 确认请求参数data准确性，data不能留空 |
| -4036 | uin校验失败 | 确认appid、openid准确性，若失败请通过企业QQ（800013811）联系移动网游MSDK技 |
| -4037 | expires字段无效(是绝对过期时间戳,如1398575082) | 确认过期时间参数准确性 |
7.1 分享到QZone(/share/qzone)
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| 1000 | 非法参数 | 确认请求参数准确性，若失败请联系MSDK客服提供技术支持。 |
| 1001 | 服务器繁忙，请稍后重试 | 稍后重试 |
| 1002 | 请先登录 | 重新授权 |
| 1025 | 请重新登录 | 重新授权 |
| 1026 | 初始化失败 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 1024 | 该应用不存在 | 确认appid准确性，若失败请联系MSDK客服提供技术支持。 |
| 1005 | 参数错误 | 确认请求参数准确性，若失败请联系MSDK客服提供技术支持。 |
| 1027 | Sendstory 分享配置参数错误 | 确认请求参数准确性，若失败请联系MSDK客服提供技术支持。 |
| 1028 | Sendstory 分享参数错误 | 确认请求参数准确性，若失败请联系MSDK客服提供技术支持。 |
| 1031 | 每天最多分享%d次，明天再来吧 | 正常错误，分享超限 |
7.2 分享到QQ(/share/qq)
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| 2 | 参数错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 7 | 内部错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 13 | 命令字错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 16 | 请求包错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 21 | 消息序列化错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 22 | 后台错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 23 | 存储错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 24 | 后台超时 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 25 | msgsender内部错误(socket,zmq) | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 26 | 分配session错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 27 | 消息太大，(整个消息体大小700byte内，previewText可不填写) | 减少分享中消息内容长度，summary不能超过20个字，若失败请联系MSDK客服提供技术支持。 |
| 28 | 构造消息错误 | 检查构造的分享消息，若失败请联系MSDK客服提供技术支持。 |
| 29 | 用户拒绝接收 | 请求另一个用户 |
| 30 | 超出了用户当天分享的次数，明天再来 | 正常错误 |
| 31 | 非法帐号 | 该账号不可用 |
| 32 | 分享目标用户非好友，或目标用户没有关注公众号：QQ手游 | 正常错误，目标用户关注了QQ手游后成功 |
| 33 | 没有权限发送 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 34 | 群发消息重复 | 正常错误，不用理会 |
| 35 | imagent返回错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 36 | 添加群发任务错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 37 | 群发分组没有粉丝 | 正常错误，不用理会 |
| 38 | 发送平台错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 100000 | 鉴权错误！uin,skey错误 | 重新授权 |
| 100001 | 参错错误！缺少必要参数，或者参数类型不对 | 确认请求参数准确性，若失败请联系MSDK客服提供技术支持。 |
| 100003 | 服务错误！请联系相关开发人员 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 100004 | 脏词错误！关键字涉黄、涉政等 | 修改描述文案 |
| 100100 | CGI只能用post方式请求 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 100101 | CGI有Referer限制 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 100012 | 服务超时错误！请联系相关开发人员 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 111111 | 未知错误！请联系相关开发人员 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 99999 | 频率限制错误 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 100021 | CSRF检测参数HASH校验 | 重试一次，若失败请联系MSDK客服提供技术支持。 |
| 220001 | 发公众号消息参数不足 | 检查参数准确性 |
| 220002 | 请求参数不合法 | 检查参数准确性 |
| 220003 | 没有找到appid对应的礼包配置 | 检查appid使用是否准确或者检查礼包是否配置准确 |
| 220011 | access_token校验错误 | 检查access_token是否有效 |
| 220012 | access_token为必填字段 | 检查access_token是否未填写 |
| 220013 | openid为必填字段 | 检查openid是否未填写 |
| 220014 | fopenids为必填字段 | 检查fopenids是否未填写 |
| 220015 | targeturl为必填字段 | 检查targeturl是否未填写 |
| 220016 | targeturl超过256长度 | targeturl长度不能超过256字节 |
| 220017 | imgurl为必填字段 | 检查imgurl是否未填写 |
| 220018 | 获取uin和tskey失败(0x711_21) | 校验登录态失败，检查登录态（openid和access_token）是否过期或填错 |
| 220019 | json格式不合法 | 检查接收好友的字段fopenids的json格式是否准确 |
| 220020 | fopenids参数格式不正确 | 检查接收好友的字段fopenids格式必须是json的list |
| 220021 | 获取uin和tskey失败(0x711_23) | 批量获取接收方好友的uin失败，检查是否接收好友的openid填错 |
| 220022 | 获取发送者uin失败 | 检查是否接收好友的openid填错或者发送方的access_token是否准确 |
| 220023 | 获取接收者uin失败 | 检查是否填写了正确的接收方openid |
| 220024 | 获取好友关系失败 | 内部逻辑拉取好友关系失败,检查发送者和接收方是否是好友关系 |
| 220025 | 非好友关系 | 自己和接收方不是好友关系 |
| 220028 | 超出频率限制 | 超过了接收者每天能接收的每天最大条数或者是发送方给同一个接收方发送超过了每天最大条数;同一用户每天最多能接收5条，最多从同一个用户每天收1条 |
| 220032 | 默认发送公众号前校验appid参数失败，目前未上架 | 反馈到MSDK联系手Q同学处理 |
| 220033 | 当前发送的消息的appid和gametag未在ams做配置 | 反馈到MSDK联系手Q同学处理 |
| 901203 | 基础侧限制发送频率：同一用户每天最多发送10条，每周最多发送40条 | 更换账号验证 |
| 901204 | 基础侧限制接收频率：同一用户每天最多能接收5条（最多从同一个用户每天接收1条），同一用户每周最多接收20条 | 更换账号验证 |
| 901205 | 基础侧限制双方互动频率：用户之间每天最多互动一次 | 更换账号验证 |
7.3 ark分享到QQ(/share/qqark)
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| 225001 | appid不能为空 | 传入对应参数 |
| 225002 | openid不能为空 | 传入对应参数 |
| 225003 | fopenid不能为空 | 传入对应参数 |
| 225004 | accesstoken不能为空 | 传入对应参数 |
| 225005 | extraJSON不能为空 | 传入对应参数 |
| 225006 | extraJSON不符合要求，见msg解析 | |
| 225007 | 校验好友关系失败 | |
| 225008 | 非好友关系不能发送消息 | |
| 225009 | appid+app+scene场景不存在、没有配置或配置没生效，绿洲配置需要约十分钟生效，若十分钟没生效请联系GameAccessHelper | |
| 225010 | ark消息组包失败 | 联系GameAccessHelper |
| 220028 | 超出频率限制 | 接收方，每天最多接收5条，接收自同一个人最多3条；发送方，每天最多30条，每周最多100条 |
8 手Q蓝钻礼包错误码
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| -10002 | 账号不存在（OpenId->QQ转换失败） | 重试一次 |
| -20001 | 系统错误 | 重试一次 |
| -20002 | 内部接口返回错误 | 重试一次 |
| -1 | 传入参数错误 | 检查输入参数准确性 |
| -2 | 签名错误 | 检查输入参数准确性 |
| -3 | 非法ip访问 | 重试一次 |
| -4 | 时间戳失效 | 重试一次 |
| -5 | 不在开放时间 | 重试一次 |
| -6 | 系统非可用状态（可能为特殊原因临时维护，经各方确认后才会关停） | 重试一次 |
| -7 | 超过方法最大调用次数（频率限制） | 重试一次 |
重试一次的，若还有问题请联系MSDK客服提供技术支持。
9 OIDB统一返回错误码
当msdk错误码为-15000~19999时，意思为调用oidb错误了，此时需要查看msg错误描述中的ret，根据ret的值来确认oidb具体的错误原因，
例如：ret:-103 msg:oidb decode0x73a failed, ret:17，此时根据ret:17在下面图标中找到对应的原因。
9.1 OIDB统一返回错误码
| 十六进制 | 有符号十进制 | 无符号十进制 | 错误描述 |
|---|---|---|---|
| 0xff | -1 | 255 | 分两种情况: 1. OIDB寻址失败2. 后端认为uin为保留号码或者超过当前最大uin，也就是业务部门过来的uin并没有生成 |
| 0xfe | -2 | 254 | uin所在的db处于维护状态，暂时不能提供服务 |
| 0xfd | -3 | 253 | uin为互动号码，该命令不允许对互动号码操作 |
| 0x9b | -101 | 155 | 发送给后端Server失败(一般为IP/端口配置错误) |
| 0x9a | -102 | 154 | 表示该命令执行时间过长或者由于网络原因超时 |
| 0x99 | -103 | 153 | 接口调用已超过申请的频率上限, 请在单子中申请调整频率 |
| 0x98 | -104 | 152 | 测试系统没有用测试号码访问，请在这里自助添加测试号码http://oidb.server.com/#serviceGroup.selfServiceMainPanel或者在testuin.oa.com申请测试号码 |
| 0x97 | -105 | 151 | 登录态验证失败 |
| 0x96 | -106 | 150 | 业务没有申请权限，对照这里排查http://km.oa.com/group/oidb/articles/show/133650 |
| 0x95 | -107 | 149 | uin黑名单限制 |
| 0x94 | -108 | 148 | ip黑名单限制 |
| 0x93 | -109 | 147 | 请求包过大 |
| 0x92 | -110 | 146 | OPEN业务无权限, 请参考http://km.oa.com/group/oidb/articles/show/143284申请Open的访问权限 |
| 0x91 | -111 | 145 | 解包错误 |
| 0x70 | -144 | 112 | 后端系统回包: uin被冻结 |
| 0x71 | -143 | 113 | 后端系统回包: 员工帐号保护系统号码 |
| 0x73 | -141 | 115 | 后端系统回包: 高级保护系统号码 |
| 0x71 | -140 | 116 | accesstoken非法，检查传入的accesstoken是否正确 |
| 0xc9 | -55 | 201 | 后端系统回包: 群server正在进行运维操作，限制机器为只读 |
| 0xca | -54 | 202 | 后端系统回包: 收到未知类型的包 |
| 0xcb | -53 | 203 | 后端系统回包: 请求包字段错误，比如群号填写超出了群server的服务范围 |
| 0xcc | -52 | 204 | 后端系统回包: 群被安全中心封停 |
| 0xec | -20 | 236 | 寻址后端Server失败(一般是命令字没有配置寻址方式) |
| 0xfb | -5 | 251 | 访问B类用户号码 |
| 0xfc | -4 | 252 | 访问BC类用户号码 |
| 0xcd | -51 | 205 | 测试环境访问频率超过限制值(请稍后再试) |
| 0xc1 | -63 | 193 | 命令未配置(一般是没有配置为ProtoBuf命令) |
| 0x5 | 5 | 5 | 命令未配置(一般是命令字没有配置到OIDB后台, 请自助配置:http://qq.server.com/oidb/addproto/) |
| 0xfa | -6 | 250 | 测试环境禁止访问该命令, 请申请正式环境的权限 |
| 0xf9 | -7 | 249 | 测试环境没有配置测试转包, 该命令不允许转抱到正式环境 |
9.2 手Q登录接口PayToken校验(0x73a)返回错误码
| 十六进制 | 有符号十进制 | 无符号十进制 | 错误描述 |
|---|---|---|---|
| 0x0 | 0 | 0 | 成功 |
| 0x10 | 16 | 16 | pay token失效（用户取消授权或过期被回收） |
| 0x11 | 17 | 17 | pay token已过期 |
| 0x12 | 18 | 18 | pay token已废除(生成新的paytoken会导致旧的废除) |
| 0x13 | 19 | 19 | appid与token不匹配 |
| 0x14 | 20 | 20 | openid长度不对（长度应该为16，二进制buffer格式） |
| 0x15 | 21 | 21 | openid非法 |
| 0x16 | 22 | 22 | openid被回收 |
| 0x17 | 23 | 23 | 验证openid返回其他失败（需要找负责人查具体原因） |
| 0x18 | 24 | 24 | openid与token不匹配 |
| 0x1b | 27 | 27 | appid非法 |
| 0x5e | 94 | 94 | pay token非法（解密失败） |
| 0x65 | 101 | 101 | 用户改密token失效 |
9.3 手Q登录接口accessToken校验(0x711)返回错误码
ret 需要转换为16进制查看（示例：0x711 service error ret=67 对应16进制为0x43）
| 错误码 | 错误描述 |
|---|---|
| 0x00: | 成功 |
| 0x01: | 失败(系统内部错误) |
| 0x10~0x11: | Appid非法 |
| 0x12: | 读取第三方信息失败 |
| 0x13~0x14 | 系统内部错误 |
| 0x20 | openid非法 |
| 0x21 | openkey非法 |
| 0x22 | openid和openkey不匹配 |
| 0x23 | openkey已过期 |
| 0x24~0x25 | 系统内部错误 |
| 0x26 | 验证签名失败 |
| 0x27 | openid被回收 |
| 0x2a | 读udc失败（openid被回收或其他失败原因） |
| 0x2e | openid非法（开心id） |
| 0x32~0x36 | openid非法（业务类型127返回） |
| 0x37~0x38 | openid被回收（业务类型127返回） |
| 0x40 | access token无效 |
| 0x41 | access token已过期 |
| 0x42 | access token已废除 |
| 0x43 | access token冻结失效((1)用户取消授权导致；（2）用户改密或者封号导致token被废弃) |
| 0x44 | access token验证失败（若必现，请检查appid和access token是否对应） |
| 0x45 | access token与openid不匹配 |
| 0x46 | access token长度不对 |
| 0x47 | access token改密或封号导致失效 |
| 0x4a | 非法access token，解码失败（非手Q access token） |
| 0x4b | 读oin不存在（一般为号码被回收或者冻结导致） |
| 0x4c | 读u2o关系不存在（一般为号码被回收或者冻结导致） |
| 0x53 | openid被回收 |
| 0x54 | 转换的openid个数错误(业务类型23返回) |
| 0x55 | 所转换的openid非法(业务类型23返回) |
| 0x56 | 请求转换openid数量超过上限（500） |
| 0x58 | 无效appid(请求数据与后端数据不一致) |
| 0x60 | 未填写openid |
| 0x61 | 未填写openkey |
| 0x62 | 非法的业务类型 |
| 0x63 | 未填写appid |
10 获取心悦超R玩家会员标识错误码
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| -1 | 内部错误 | 反馈到MSDK联系心悦服务处理 |
| -1001 | 输入参数不合法或缺少必传字段 | 按照参数列表检查参数是否正确 |
| -1002 | 请求过载 | 反馈到MSDK联系心悦服务处理 |
| -1003 | db操作失败 | 反馈到MSDK联系心悦服务处理 |
| -1004 | 登录态校验失败 | 反馈到MSDK联系心悦服务处理 |
11 获取心悦微信平台玩家会员标识错误码
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| -105 | 账号不存在或账号不合法 | 反馈到MSDK联系心悦服务处理 |
| -109 | 内部redis错误,获取信息失败 | 反馈到MSDK联系心悦服务处理 |
| -400 | 用户有效期错误 | 反馈到MSDK联系心悦服务处理 |
| 10 | redis不存在此账号信息 | 反馈到MSDK联系心悦服务处理 |
| 100 | 过期用户 | 反馈到MSDK联系心悦服务处理 |
| 101 | 黑名单用户 | 反馈到MSDK联系心悦服务处理 |
| 102 | 白名单用户 |
12 Apple登录错误码
| 错误码 | 错误描述 | 推荐处理 |
|---|---|---|
| -3003 | CLIENT_SECRET配置错误 | 检查飞鹰系统“MSDKV3苹果渠道配置”准确性 |
| -3006 | body参数非法 | 检查body参数准确性 |
| -3008 | 非200错误 | 核对BundleId与飞鹰系统是否一致 |
| -3011 | 读取token失败 | 检查客户端与服务端MSDK环境是否一致 |
| -3015 | 校验token失败 | 检查客户端与服务端MSDK环境是否一致 |