使用场景:

企业其它渠道消耗用户积分余额


接口地址 /api/integrate/audience/point/change

请求方式 POST

consumes ["application/json"]

produces ["application/json"]

接口描述 用户积分变更接口

应用权限 积分->用户积分变更

#请求参数


###请求头参数

参数名称参数说明请求类型是否必须数据类型schema
X-Token自建应用访问tokenheadertruestring

###公共参数

参数名称参数说明请求类型是否必须数据类型schema
data变更数据,每次最大500条bodytruearray用户积分变更

###用户积分变更

  • 用户匹配顺序 thirdId > audienceUserId,匹配标识必传一种
参数名称参数说明请求类型是否必须数据类型schema
audienceUserId用户IDbodyfalseLong
thirdId第三方用户IDbodyfalseString
nickName昵称bodyfalseString
avatar头像bodyfalseString
orderNo交易号,变更请求唯一识别IDbodytrueString
contentId触发变更的内容IDbodyfalseString
contentName触发变更的内容名称bodyfalseString
eventType行为类型(createExchangeOrder:创建兑换订单, pointTrim:增减积分, pointOverdue:过期积分)bodytrueString
exchangeType变动类型(1:获得, 2:消耗)bodytrueint
exchangePoint变动积分bodytrueint
remark备注bodyfalseString
actionTime操作时间,格式:yyyy-MM-dd HH:mm:ssbodytrueString

###请求示例

{
    "data":[{
        
    }]
}

#响应参数


参数名称参数说明请求类型是否必须数据类型schema
code状态码bodytruestring
errorCode异常码bodytruestring
msg描述bodytruestring
data响应数据bodytrueobject用户积分变更结果

###用户积分变更结果 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | status | 任务状态(-1: 失败, 0: 进行中, 1: 成功, 2: 部分成功) | body | true | int | | | errorData | 变更失败数据 | body | false | array | 用户积分变更 | | successData | 变更成功数据 | body | false | array | 积分记录 |

###积分记录 | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema | | ------ | ------ | ------ | ------ | ------ | ------ | | orderNo | 交易号,变更请求唯一识别ID | body | true | String | | | pointRecordId | 积分记录ID | body | true | Long | |

###响应状态

状态码说明schema
200OK
201Created
401Unauthorized
403Forbidden
404Not Found

###响应示例

{
    "code": "200",
    "errorCode": "SUCCESS",
    "msg": "ok",
    "data": null
}

  • 无标签