积分、权益体系集成

>1. 支持互动与自有系统积分、权益体系打通。
>1. 实现互动界面部分个性化文案展示。

## 对接步聚

1. 根据需要开发调用数据API程序，即可获取对应数据;
1. 打开ecmp控制后台，并在应用管理->互动编辑器->权益查询设置->添加，配置对应URL;见下图1。
1. 创建互动作品并进入互动编辑器；
1. 在编辑器 基础设置->参与条件设置->权益展示，开启并选择权益接口即可。
![](/media/202205/2022-05-26_185406_020808.png)
权益接口配置
![](/media/202205/2022-05-26_185347_344523.png)

5. 最终展示
![](/media/202205/2022-05-26_185448_692806.png)

## 接口规范
- 方法类型：POST
- Content-Type：application/json
- 接口入参
| 参数名 | 是否必须 | 参数类型 | 参数说明 |
| --- | --- | --- | --- |
| nonce | 是 | String | 随机字符串 |
| timestamp | 是 | Long | 当前 UNIX 时间戳，可记录发起 API 请求的时间。例如1529223702 |
| signature | 是 | String | 请求签名。 |
| msgEncrypt | 是 | String | 数据明细,不同业务类型，数据格式不一样 |

- msgEncrypt解密数据格式 
| 参数名 | 是否必须 | 参数类型 | 参数说明 |
| --- | --- | --- | --- |
| id | 是 | Number | 作品id |
| code | 是 | String | 作品code |
| mobile | 否 | String | 手机号(手机授权模式) |
| openId | 否 | String | 1.对接方访客唯一Id(自定义授权模式) <br/>2.微信openId(微信授权模式) |
| nickName | 否 | String | 微信昵称(微信授权模式) |
| corpOpenId | 否 | String | 企业openId，平台型企业使用 |
| customLotteryParams | 否 | obj | 如果同时启用了自定义规则且设置了消耗和门槛，这里会携带所设置的参数 |

- 接口返回值
至少包含code和msg参数。
```json
{
	"code": "200",
  	"msg": "ok",
  	"obj": {
    	"benefitShowDesc": "剩余100积分"
  	}
}
```
| 参数名 | 是否必须 | 参数类型 | 参数说明 |
| --- | --- | --- | --- |
| code | 是 | String | 200请求正确，其他视为失败 |
| msg | 是 | String | 错误描述 |
| obj.benefitShowDesc | 是 | String | 权益描述，限制50个字。超出后，截取前50字。 |