# 其他接口

# 1. 任务获取接口

# 说明

平台侧实现该接口,用来返回平台任务的配置信息。 例如平台侧需要三个条件:满足观看 5min 发货,满足观看 10min 发货,如果根据接口 2 则需要提供两个 taskId 分别对应两个发货,在这种情况可以用这个接口,curVal 返回当前用户的观看时长,由 腾讯游戏来联 活动系统自行判断时长,减少平台的配置工作量。

# 接口入参

字段名称 字段类型 字段是否必填 字段说明
userId string 平台用户 ID
taskId string 平台任务 ID
ts int 时间戳(平台侧会带时间戳来访问腾讯的接口,这里会将时间戳透传给平台,防止一些任务判断的临界问题)

# 接口返回

字段名称 字段类型 字段是否必填 字段说明
code int 错误码,0 表示成功
msg string 错误提示
curVal string 当前值
expectVal string 期望值

# 2. 资格扣减

# 说明

平台侧实现该接口,用来发货之前确认扣减平台侧发货资格次数。

# 接口入参

字段名称 字段类型 字段是否必填 字段说明
userId string 平台用户 ID
taskId string 平台任务 ID
serialCode string 幂等标识
num int 扣减次数

# 接口返回

字段名称 字段类型 字段是否必填 字段说明
code int 错误码,0 表示成功
msg string 错误提示

# 3. 资格增加

# 说明

平台侧实现该接口,用来处理扣减资格成功但发货失败的回滚场景。

# 接口入参

字段名称 字段类型 字段是否必填 字段说明
userId string 平台用户 ID
taskId string 平台任务 ID
serialCode string 幂等标识
num int 增加次数

# 接口返回

字段名称 字段类型 字段是否必填 字段说明
code int 错误码,0 表示成功
msg string 错误提示
lastUpdate: 11/6/2023, 11:13:32 AM