合力拆红包拆取判断逻辑(ver 20160830

合力拆红包拆取判断逻辑

主要应用场景:合力拆红包活动页面,用户进行帮拆时调用

接口调用请求说明

http请求方式: POST,GET 
接口地址: /api/home/GetCooperativeBonus

参数说明

参数 是否必须 说明 版本号
cbId 合力拆红包id 20160830

调用举例

$.ajax({
                type: "Get",
                url: "/api/home/GetCooperativeBonus",
                async: false,
                data: "cbId=" + $("#cbId").val() + "&d=" + new Date().getTime(),
                success: function (msg) {
                }
            });

返回说明

正常情况下,会返回商品实体的相关信息:

成功返回json
{
    "ret": "0",--0表示成功
    "data": {--合力拆详细情况对象
        "Id": 81,
        "Bonusid": 198,--合力拆红包id
        "Userid": 476,--帮拆用户id
        "Username": "ant123",--帮拆用户名
        "TakePercent": 0.216,--拆取百分比
        "Result": "{user}在红包上撕开了{data}的口子。",--帮拆提示语模板
        "CreateTime": "2016-08-06T15:42:45.4103163+08:00",--帮拆时间
        "State": 0,--状态(0为正常,-1为删除)
        "ModifyTime": "2016-08-06T15:42:45.4113164+08:00"--修改时间
    },
    "userTimes": 4--剩余可帮拆次数
}

错误时状态码不会是1000,JSON数据包示例如下(该示例为参数错误):

返回单纯字符串表示失败
"1001"//参数不全
"1002"//红包不存在
"1003"//用户未登陆

返回json中ret为-1表示失败
{
    "ret": "-1",-- -1表示失败
    "data": "",
    "userTimes": 4--剩余可帮拆次数
}
此时data:
"NoExist"//红包不存在
"Expired"//红包已过期
"IsFinished"//红包已被拆开
"NoTimes"//帮拆次数已用完
"Fail"//拆取失败