扣除积分

“积分”：是活动中用户可扣除的载体，如：积分、金币、代币等

当活动用户需要获得或者扣除“积分”的时候，如：参与瓜分金币，会请求活动配置的回调地址

调用方式

请求方式: 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 - 扣除“积分”因为余额不足而失败

活动任务完成奖品回调通知