增加活动抽奖次数

优质
小牛编辑
120浏览
2023-12-01

接口地址

https://activity.m.duiba.com.cn/activityVist/addTimes?

使用场景

开发者通过判断用户的某些行为操作,向兑吧增加抽奖次数接口发送请求,从而给用户增加某个活动的免费抽奖次数,如:用户将A活动进行分享,开发者通过调用兑吧增加抽奖次数接口,为该用户增加一次免费抽奖机会。

使用说明

该交互形式适用于兑吧现有的活动类型及游戏(暂不支持单品抽奖、手动开奖、秒杀活动、答题、测试题、竞猜、积分游戏),须由开发者解析活动链接中参数id的值,该值即为activityid的值,且在uid与activityid之间建立关系。 兑吧服务端接收请求,实时给uid所对应的activityid增加免费参与次数,并将处理结果响应开发者服务端

注意:接口使用的前提是用户需要在兑吧有访问记录。如果用户没有访问过兑吧页面,该接口无法给用户增加抽奖次数。

重试机制

由于网络异常等原因,若开发者发送请求5秒后未收到兑吧的响应,则再次发送请求,期间每隔5s、10s、30s重新请求,最多请求3次。兑吧将会对二次请求进行去重,保证一次有效请求只被成功处理一次。

接口参数说明

输入参数(Get请求方式):

参数是否必须参数类型限制长度参数说明
appKeyyesstring255接口appKey,应用的唯一标识
timestampyesstring201970-01-01开始的时间戳,毫秒为单位
activityIdyesstring20要增加次数的活动id
timesyesstring20需要增加的次数
validTypeyesInteger增加次数类型,值为0和1(传0标示永久,传1标示每天)
uidyesstring255用户标识,唯一且不可变
bizIdyesstring255保证其唯一性
signyesstring255MD5签名,参见【签名规则

注意:validType增加活动次数的类型, 如果是0,表示活动增加的是永久次数;如果是1,表示每天增加的次数,增加次数第二天会重置

接口使用须知(重要!)

1、同一个用户,每天调用增加抽奖次数的请求次数不超过12次,否则将无法正常增加次数。

2、使用增加抽奖次数功能需要联系兑吧技术支持开通增加抽奖次数权限。否则调用加次数接口无法正常增加抽奖次数。请联系兑吧技术支持开通权限。

请求示例:

https://activity.m.duiba.com.cn/activityVist/addTimes?uid=1&activityId=124323&times=2
&bizId=1498793930342&sign=30f33f2ade4f8d31e2a0005b6f83bbb0&appKey=jlg88lyxz7siqtmr&amptimestamp=1498793930343&

响应参数:

参数是否必须参数类型限制长度参数说明
successyesboolean是否增加次数成功
messagenostring255出错原因
countnoint10总的增加抽奖次数

响应示例:

成功:{"success":true,"count":12}

失败:{"success":false,"message":"uid不正确"}