# 全局返回码
# 接口返回样式
接口调用后会返回 JSON 格式的响应数据，根据调用结果分为 正常返回 和 错误返回 两种情况。以下是具体的返回样式及字段说明：
# 正常返回
{
"iRet": 0,
"v": 2,
"apiName": "FlowTaskQuery",
"jData": {
"flowVal": true,
"reason": "ok",
"code": 0
},
"sMsg": "ok",
"tid": "173629138131790391"
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
说明：
- iRet: 返回码，0为成功，其他为失败
- v: 返回数据版本，目前为2
- apiName: 接口名称
- jData: 返回数据， 其中jData结构来自具体apiName。更多返回结构参考:《接口标准返回》
- sMsg: 返回消息，通常用于描述操作结果（如 "ok"）。
- tid: 请求唯一标识符，用于追踪请求。
# 错误返回
{
"iRet": -1,
"apiName": "Error",
"v": 2,
"sMsg": "用户条件不满足",
"tid": "169805592519513122"
}
1
2
3
4
5
6
7
2
3
4
5
6
7
说明：
- iRet: 返回码，0为成功，其他为失败
- v: 返回数据版本，目前为2
- apiName: 接口名称
- sMsg: 返回消息，通常用于描述操作结果（如 "ok"）。
- tid: 请求唯一标识符，用于追踪请求。
# 目录
# 通用类
通用类
| 错误码 | 描述 | 处理建议 |
|---|---|---|
| -1000 | 签名错误 | sig字段计算签名与后端不一致，需要调用方参考流程调用sig签名完成修改 |
| -4001 | 参数错误 | 缺少请求参数或者场景值，请对照开始调用流程检查参数 |
| -4003 | 请求过期 | 更换请求时间戳参数 |
| 200000 | 内部错误 | 提示用户稍后重试，如果是发货请使用同一个幂等号 |
| -999999 | 请求参数错误 | 参照sMsg返回的提示 |
| 9990015 | 活动请求限流 | 稍后重试，如果是较大请求量的活动提前联系运营报备 |
| -4011 | 用户级限流 | 提示用户稍后重试 |
| -1160000 | 内部系统错误 | 多次尝试错误可与开发定位具体问题 |
# 用户绑定账号类
用户绑定账号类
| 错误码 | 描述 | 处理建议 |
|---|---|---|
| -4002 | 未绑定游戏/平台账号 | 引导用户先进行账号绑定 |
| -4005 | 未绑定游戏/平台账号（不可换绑活动） | 提示用户先在活动中绑定 |
| -4006 | 该游戏账号已被绑定至其他渠道ID | 使用其他渠道的用户id解绑或绑定其他可用的游戏账号 |
| -4007 | 用户绑定活动功能未开启 | 活动未开启禁止换绑，该接口不可用。确认当前活动已开启“禁止换绑” |
| -4008 | 未绑定QQ | 当前流程需要登记QQ，如果用户并未登记QQ,则需要先引导用户绑定QQ |
| -4009 | 手机系统限制 | 当前活动已限制手机类型参与，可在活动中“IOS设备限制绑定安卓角色”确认是否关闭该限制 |
| -4010 | 用户不在白名单中 | 当前活动为测试活动需要使用白名单访问，可联系平台/游戏运营添加测试白名单 或者将活动发布 |
| -4011 | 访问频率过快 | 渠道中单个用户uid访问频率过快，需要用户正常访问或稍后重试 |
| -4014 | 账号角色信息已失效，请重新绑定账号 | 当前业务配置了校验用户角色有效性检查，当前用户角色信息已失效(合服，角色转区)，引导用户重新绑定角色 |
| -1020002 | 绑定已失效或角色不存在，请重新完成角色绑定 | 游戏合服等导致，需要引导用户删除后重新绑定 |
| -1110002,-1110003 | openid转换请求失败 | 未获取到用户对应游戏的账号，引导用户先创建角色，如未解决可与开发定位具体问题 |
| -1140006 | 绑定关系不存在 | 引导用户重新绑定后再尝试 |
| -1140007 | 授权游戏帐号与当前登陆帐号不一致，请重新登陆 | 用户授权使用的账号与当前使用的账号不一致，引导用户修改绑定关系后重试 |
| -1140200 | 没有找到对应的渠道用户 | 先登录小程序之后，并引导用户在活动中重新绑定角色 |
| -1140400 | 无权限 | 重新小程序之后，重试 |
| -1140700 | 需要登录游戏账号 | 引导用户重新绑定 |
| -1140801 | 请登录当前绑定游戏角色的账号 | 重新绑定，确保当前游戏角色属于当前QQ下的账号角色 |
| -1140900 | 当前登录用户与账户绑定用户不一致，请登录账号绑定用户 | 引导用户重新绑定 |
| -200001 | 该账号未到可换绑时间，请使用其他账号 | 当前账号处于换绑冷却期，无法立即更换绑定，请引导用户使用其他账号或等待冷却期结束 |
# 活动参与类
活动参与类
| 错误码 | 描述 | 处理建议 |
|---|---|---|
| -5019 | 比较结果丢失 | 该功能依赖第三方接口，第三方接口请求超时或者返回不满足预期，遇到此问题需要开发协助定位 |
| -7001 | 活动未开始 | 确认活动开始时间 |
| -7002 | 活动已结束 | 确认活动结束时间 |
| -7003 | 活动已下线 | 确认活动上下线状态 |
| -7004 | 活动流程不存在 | 调用流程中使用了错误的流程ID，确认携带的流程号flowId是否存在对应的活动中 |
| -7005 | 流程不合法 | 当前流程配置错误，需要联系运营人员确认流程配置是否正确 |
| -7006 | 活动流程未开始 | 流程开启了单独的时间控制，需确认流程开始时间 |
| -7007 | 活动流程已结束 | 流程开启了单独的时间控制，需确认流程结束时间 |
| -16007 | 活动不存在 | 确认当前使用的活动ID是否存在，或已发布，或当前时间是否在活动时间内 |
| -16018 | 用户未授权 | 活动存在权限点配置，需引导用户完成隐私场景授权 |
| -1090105 | 找不到隐私授权配置 | 检查活动是否配置了隐私授权，并检查请求参数中gameAuthScene与活动一致，参考文档获取隐私授权描述信息 |
| -1090106 | 找不到活动配置 | 检查当前活动是否上线，或者当前时间在活动期间内，参考文档活动立项说明 |
| -1190009 | 流程配置错误 | 流程配置缺少参数，需调用方提供对应的错误流程ID，并由livelink运营协助完成流程配置更新 |
| -1190020 | 您已经参加过其他互斥活动 | 提示用户再其他渠道已经参与过了，奖励只能领取一次。原因：多个活动中使用同一个互斥组，用户参与其中之一活动，无法继续参与其他活动 |
| -1190016 | 用户未预约游戏 | 当前流程配置了“检查游戏预约绑定账号”，但用户并未完成游戏预约，需引导用户先完成游戏预约 |
| -1190017 | 用户存在多个预约账号 | 用户渠道ID中存在同一个游戏下的多个游戏账号，需联系开发处理 |
| -1140601 | 无效二维码，请重新生成二维码并扫码 | 引导用户刷新并重试 |
| -1140602 | 二维码已被使用，请重新生成二维码并扫码 | 引导用户刷新并重试 |
| -1140603 | 刷新二维码频率过快，请间隔5秒后重试 | 引导用户重试，控制页面刷新频率 |
# 礼包发放类
礼包发放类
| 错误码 | 描述 | 处理建议 |
|---|---|---|
| -1 | 用户不满足条件 | 引导用户先完成任务 |
| -3018 | 订单已存在 | 当前订单处理中，稍后再试 |
| -4016 | 账号存在安全风险 | 用户信用分过低，引导用户前往【腾讯游戏信用】官网或【公众号】了解详情 |
| -10001 | 用户积分数量不足 | 确认用户之前是否使用相同账号领取了对应积分 |
| -16005,-1120004 | 用户资格不足，无法参与活动 | 确认用户之前是否使用同一个账号参与过活动，确认没参与过可联系运营协助 |
| -31001 | 发货网络异常 | 可稍后重试，此状态超过30min可联系运营协助 |
| -31002 | 礼包限量 | 确认用户是否已领取过或者联系运营确认礼包总数 |
| -31004 | 发货订单正处理中 | 稍后重试，此状态超过30min可联系运营协助 |
| -1190013,-1190014 | 礼包单未发布 | 联系运营确认礼包状态 |
| -1120000 | 扣除资格未知错误 | 多次尝试失败后与开发定位具体问题 |
| -1120006 | 资格已过期 | 引导用户重试 |
# 隐私授权类
隐私授权类
| 错误码 | 描述 | 处理建议 |
|---|---|---|
| -180001 | 隐私授权信息不存在 | 当前请求中传入的gameAuthScene字段对应的隐私授权未发布或不存在，确认传入无误后与运营确认当前活动的隐私是否发布 |
| -180002 | 隐私授权未发布 | 联系运营发布隐私授权 |
| -1170103 | 隐私授权与输入信息不匹配 | 隐私授权信息与用户提交的信息不符，比如对应的游戏等，引导用户重试 |
# 游戏账号类
游戏账号类
| 错误码 | 描述 | 处理建议 |
|---|---|---|
| -120004 | 用户角色未创建 | 当前用户并未登录过wegame，需要用户前往wegame登录一次，并完成wegame账号创建 |
| -1140100 | 没有找到对应的游戏角色 | 当前游戏角色和微信账号没有对应关系，引导用户重新进入活动页面或微信小程序 |
| -1140101 | 没有绑定游戏角色 | 当前渠道ID下无对应角色，引导用户先完成绑定 |
| -1140104 | 游戏角色已失效，请重新添加游戏角色 | 引导用户删除角色之后使用新角色重新绑定 |
| -1110017,-1170108,-1110017,-1110018 | 游戏角色不存在 | 用户未绑定角色，或者绑定角色已失效(转服，合服)，需引导用户重新绑定角色 |
| -1110006 | 查询用户礼包记录请求失败 | 需开发定位具体问题 |
| -1130001,-1130004 | 验证码错误 | 引导用户重新输入验证码 |
| -1130002 | 未知用户 | 当前手机号码未获取到对应的渠道用户，引导用户去对应的合作渠道先完成手机注册 |
| -1130003,-1130006 | 验证码已失效 | 引导用户重试 |
| -1130005 | 请求验证码过于频繁 | 请求过于频繁，引导用户一分钟尝试 |
| -1140003 | 网络繁忙,请稍后再试 | 用户操作并发，引导稍后重试 |
| -1190010 | ams返回码异常 | 游戏数据接口错误，保留错误日志并与开发确认具体信息 |
| -9990005 | 校验手机号验证码失败 | 验证码错误或已过期，引导用户重新获取验证码 |
| -9990006 | 重复请求太频繁，请稍后重试 | 命中接口频率限制，可稍后重试，或者提前与运营人员做好活动节点报备 |
| -1250001 | 网络繁忙,请稍后再试 | 用户操作并发，更新绑定失败，引导用户稍后再继续操作 |