增加活动抽奖次数

接口地址

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

使用场景

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

使用说明

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

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

重试机制

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

接口参数说明

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

参数 是否必须 参数类型 限制长度 参数说明
appKey yes string 255 接口appKey,应用的唯一标识
timestamp yes string 20 1970-01-01开始的时间戳,毫秒为单位
activityId yes string 20 要增加次数的活动id
times yes string 20 需要增加的次数
validType yes Integer 增加次数类型,值为0和1(传0标示永久,传1标示每天)
增加抽奖次数规则详见配置规则
uid yes string 255 用户标识,唯一且不可变
bizId yes string 255 保证其唯一性
sign yes string 255 MD5签名,参见【签名规则

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

配置规则

抽奖次数增加类型(validType)需要结合活动配置的参与类型(永久,每天/每月),活动配置的次数参与类型不同,增加次数的的效果也有所不同,用户需要结合自己业务场景进行活动配置和接口调用,否则无法实现自己想要的效果,以下对活动配置类型和增加抽奖次数类型做相关解释说明: 1.如果业务场景是想实现增加的抽奖次数永久有效,则增加抽奖次数类型需要传永久类型(validType传0),同时活动配置的参与次数类型也要配置永久参与。

2.如果用户想实现增加的抽奖次数用户当天使用,不适用第二天会重置,则增加次数类型配置每天(validType传1),同时活动配置的次数参与类型也配置每天。

3.因为增加次数抽奖类型的匹配条件有限,目前不支持每月参与的类型,请谨慎使用。

4.增加抽奖次数的逻辑和规则如下:

a.配置永久+每天:明天等于抽奖后剩余次数,若没有抽奖,则明天为配置的永久次数

例:

配置永久次数3,每天+1,今天抽奖2,则明天抽奖次数为2

配置永久次数3,每天+1,今天没抽奖,则明天抽奖次数为3

b.配置每天+每天:明天等于配置的每天次数

例:

配置每天次数3,每天+1,今天抽奖2,则明天抽奖次数为3

配置每天次数3,每天+1,今天没抽奖,则明天抽奖次数为3

c.配置永久+永久:明天等于抽奖后剩余次数

例:

配置永久次数3,永久+1,今天抽奖2,则明天抽奖次数为2

配置永久次数3,永久+1,今天没有抽奖,则明天抽奖次数为4

d.配置每天+永久:明天等于每天+永久的总和

例:

配置每天次数3,永久+1,今天抽奖2,则明天抽奖为4

配置每天次数3,永久+1,今天没有抽奖,则明天抽奖次数为4

如有疑问,请咨询兑吧技术支持提供相关接口支撑。

接口使用须知(重要!)

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

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

请求示例:

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

响应参数:

参数 是否必须 参数类型 限制长度 参数说明
success yes boolean 是否增加次数成功
message no string 255 出错原因
count no int 10 总的增加抽奖次数

响应示例:

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

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

results matching ""

    No results matching ""