积分扣领
“积分”:是活动中用户可扣除的载体,如:积分、金币、代币等
当活动用户需要获得或者扣除“积分”的时候,如:参与瓜分金币,会请求活动配置的回调地址
调用方式
- 请求方式: POST
- 回调地址:Dashboard -> Re.Boost -> 回调地址中设置
请求头参数(Header)
| 参数 | 必须 | 值 | 说明 | 
|---|---|---|---|
| Content-Type | 是 | application/json | 声明json格式 | 
| Authorization | 是 | Bearer md5(OpenSecret+(空格)+md5(请求body)) | OpenSecret 获取方式:Dashboard > 开发配置 > 开放平台秘钥 获取OpenSecret | 
请求参数
请求包体:
{
    "user_id": "your app user ID",
    "campaign_id": "cje49g6rdj7lp3l9rslg",
    "title": "活动标题",
    "state": "deduct",
    "num": 100,
    "source": "coin",
    "gain_id": "274955417019097088",
}参数说明:
| 参数 | 必须 | 类型 | 说明 | 
|---|---|---|---|
| user_id | 是 | string | 活动用户的ID标识,也就是app项目提供的用户标识 | 
| campaign_id | 是 | string | 活动 ID | 
| title | 是 | string | 活动标题 | 
| state | 是 | string | 变动类型 (deduct - 扣除, gain - 获得) | 
| num | 是 | number | 扣除或者获得的数量 | 
| source | 是 | string | 来源枚举(coin - 瓜分金币活动) | 
| gain_id | 否 | string | 获得“积分”唯一标识,用户可以根据这个字段判断是否为重复获得 | 
tip: state 枚举类型 (deduct - 扣除, gain - 获得) deduct - 用户需要扣除“积分”参与活动 gain - 用户从活动获得“积分”
响应处理
用户需要返回以下json格式数据
{
    "code": 200,
    "msg": "",
    "data": {
        "state": "success",
        "relate_id":"274955417019097088"
    }
}响应参数说明:
| 参数 | 必须 | 类型 | 说明 | 
|---|---|---|---|
| code | number | string | 请求响应结果,如果请求响应成功,请返回200 | 
| msg | 否 | string | 请求响应异常信息,如果非200情况下,可以用该字段提供错误信息 | 
| data | 是 | object | 业务响应数据 | 
| data.state | 是 | string | 扣除/获得“积分”状态(success - 成功,lack - 不足) | 
| data.relate_id | 否 | string | 关联的处理ID,如果有关联的处理ID可以提供,可以方便后续查询具体情况 | 
Tips: state 扣除/获得积分状态 (success - 成功,lack - 不足)
- success - 处理扣除/获得“积分成功”
- lack - 扣除“积分”因为余额不足而失败