使用场景:
...
企业减少用户积分
Markdown |
---|
**接口地址** `/api/open/point/decrease`
**请求方式** `POST`
**consumes** `["application/json"]`
**produces** `["application/json"]`
**应用权限** `无需授权`
#请求参数
***
###请求头参数
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
| ------ | ------ | ------ | ------ | ------ | ------ |
| X-Token | 自建应用访问token | header | true | string | |
###公共参数
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
| ------ | ------ | ------ | ------ | ------ | ------ |
| nonce | 6位随机字符串 | body| true | string | |
| timestamp | unix时间戳(毫秒) | body | true | long | |
###用户增加积分信息
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
| ------ | ------ | ------ | ------ | ------ | ------ |
| audienceUserId | 用户ID | body| false | Long | |
| thirdId | 第三方用户ID | body| false | String | |
| point | 积分增加值 | body | true| Integer | |
| remark | 备注 | body | true| String | |
| eventType | 行为类型 | body | false | String | |
| relateBizCode | 关联业务编码 | body | false | String | |
###请求示例
```json
{
"appInstanceId": 0,
"audienceUserId": 860484273911119872,
"eventType": "",
"nonce": "123456",
"orgId": "",
"point": 10,
"relateBizCode": "业务编码",
"remark": "测试减少",
"thirdId": "",
"timestamp": 0
}
```
#响应参数
***
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
| ------ | ------ | ------ | ------ | ------ | ------ |
| code | 状态码 | body | true | string | |
| errorCode | 异常码 | body | true | string | |
| msg | 描述 | body | true | string | |
| data | 用户积分是否减少成功 | body | true | boolean | |
###响应状态
| 状态码 | 说明 | schema |
| ------ | ------ | ------ |
| 200 | OK | |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found | |
###响应示例
```json
{
"code": "200",
"errorCode": "SUCCESS",
"msg": "ok",
"data": true
}
``` |