# 全局返回码

# 接口返回样式

# 正常返回

{
  "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

说明：

iRet: 返回码，0为成功，其他为失败
v: 返回数据版本，目前为2
apiName: 接口名称
jData: 返回数据，其中jData结构来自具体apiName。更多返回结构参考:《接口标准返回》
sMsg: 返回消息
tid: 请求唯一标识

# 错误返回

{
  "iRet": -1,
  "apiName": "Error",
  "v": 2,
  "sMsg": "用户条件不满足",
  "tid": "169805592519513122"
}

1
2
3
4
5
6
7

说明：

iRet: 返回码，0为成功，其他为失败
v: 返回数据版本，目前为2
apiName: 接口名称
sMsg: 返回消息
tid: 请求唯一标识

# 全局错误码

# 通用类

错误码	说明	处理建议
0	请求成功
200000	内部错误	提示用户稍后重试，如果是发货请使用同一个幂等号
-999999	请求参数错误	参照sMsg返回的提示
-1000	请求签名错误	确认签名计算规则
-4003	请求过期	更换请求时间戳参数
9990015	活动请求限流	稍后重试，如果是较大请求量的活动提前联系运营报备
9990017,-4011	用户级限流	提示用户稍后重试

# 活动参与类

错误码	说明	处理建议
-7001	活动未开始	确认活动开始时间
-7002	活动已结束	确认活动结束时间
-7003	活动已下线	确认活动上下线状态
-16007	活动不存在	确认活动ID货物，或活动时间不在当前可访问的时间内
-7004	活动流程不存在	确认携带的流程号flowId是否正确
-7006	活动流程未开始	流程开启了单独的时间控制，确认开始时间
-7007	活动流程已结束	流程开启了单独的时间控制，确认结束时间
-4002	未绑定游戏/平台账号	引导用户先进行账号绑定
-4005	未绑定游戏/平台账号（不可换绑活动）	提示用户先在活动中绑定
-4008	未绑定QQ	活动需要登记QQ,先引导用户绑定QQ
-4010	用户不在白名单中	联系平台或游戏运营添加测试白名单
-1020002	绑定已失效或角色不存在，请重新完成角色绑定	游戏合服等导致，需要引导用户删除后重新绑定
-1110017	游戏角色不存在	用户未绑定角色，或者绑定角色已失效(转服，合服)，平台侧需引导用户重新绑定角色
-1190016	未进行游戏预约	引导用户进行新游预约
-200001	不可换绑活动，未到换绑时间	提示用户该活动目前无法换绑
-180002	隐私授权未发布	联系运营发布隐私授权
-1190020	您已经参加过其他互斥活动	多个活动中使用同一个互斥组，用户参与其中之一活动，无法继续参与其他活动
-16018	用户未授权	引导用户完成隐私场景授权

# 任务礼包发放类

错误码	说明	处理建议
-1	用户不满足条件	引导用户先完成任务
-16005,-1120004	用户资格不足，无法参与活动	确认用户之前是否使用同一个账号参与过活动，确认没参与过可联系运营协助
-31004	发货订单正处理中	稍后重试，此状态超过30min可联系运营协助
-10001	用户积分数量不足	确认用户之前是否使用相同账号领取了对应积分
-31002	礼包限量	确认用户是否已领取过或者联系运营确认礼包总数
-4016	账号存在安全风险	提示用户请前往【腾讯游戏信用】官网或【公众号】了解详情
-1190013,-1190014	礼包单未发布	联系运营确认礼包状态

← 调用指引平台侧构建code →