数据推送

> 通过实时或近实时将在易企秀侧产生的业务数据（如表单、访客数据等）推送给企业端，方便企业产品进行二次开发或数据留存。

## 集成步骤
1. [开发数据接收程序](https://hc.eqxiu.cn/doc/24/#h2-u6570u636Eu63A5u6536u7A0Bu5E8Fu5F00u53D1u8BF4u660E "开发数据接收程序")；
1. [配置推送地址](https://hc.eqxiu.cn/doc/24/#h2-u914Du7F6Eu63A8u9001u5730u5740 "配置推送地址")；
1. [配置回调密钥](https://hc.eqxiu.cn/doc/24/#h2-u914Du7F6Eu56DEu8C03u5BC6u94A5 "配置回调密钥")；

## 数据接收程序开发说明
> 开发一个接口,用于接收推送数据;
重试机制：时间间隔为：20\40\80\160\320 秒，至多推送5次
### 接口规范

- 方法类型：POST
- 接口入参
| 参数名 | 是否必须 | 参数类型 | 参数说明 |
| --- | --- | --- | --- |
| nonce | 必须 | String | 随机字符串，一般为UUID |
| timestamp | 必须 | Long | 当前 UNIX 时间戳，可记录发起 API 请求的时间。例如1529223702 |
| signature | 否 | String | 请求签名，防止请求数据被篡改，如果需要更高的安全等级，请添加此参数。 |
|  |  |  |  |
| msgEncrypt | 必须 | JSONARRAY | 业务数据加密值,不同业务类型，数据格式不一样,加密方法见下文说明 |

- 接口返回值格式
```json
{
  	"code":"200",
 	 "msg":"xxxx"
} 
```

### 业务数据明文结构示例
```json
{
	"eventType": "preview_lottery",
	"create_time": "2022-01-01 01:01:01",
	"corpOpenId": "d727c5cdb3d044f39965344263dbe39e",
	"eventId": "1727sdfcdb3d044DFs965344263dbe89w",
	"eventData": "{\"id\":\"xxxx\"...}"
}
```

### 字段说明
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| eventType | String | 事件类型，[查看事件列表](https://hc.eqxiu.cn/doc/16/)  |
| createTime | String | 事件发生的时间格式如【2021-10-12 20:19:19】 |
| corpOpenId | String | 企业openId【平台使用】 |
| eventId | String | 事件Id,可用与重复校验 |
| eventData | String | 事件业务数据，不同事件内容不同，见对应的描述文档 |

### 加密方法说明

- timestamp：请求时的当前时间戳
- nonce：请求时生成的随机字符串，一般为UUID
- signature：根据timestamp、nonce以及用户(对接方)配置的回调密钥(SignatureKey获取方式见下图)生成的签名，具体方式如下：
`将timestamp、nonce、SignatureKey的值，按字典顺序排序，然后进行sha1加密，加密后生成的16进制字符串即为signature的值。
signature = sha1(sort(timestamp,nonce,SignatureKey))`
- msgEncrypt: 由服务器将要向用户发送的内容，通过下图的EncodingKey加密后生成,具体方式如下:
`msgEncrypt = AES(data,EncodingKey) `

- 解密方式 **[JAVA示例代码](https://gitee.com/eqxiu-ee/hd-lottery-demo "示例代码")**

### 请求示例
**Bash**
```bash
curl -H "Content-Type: application/json" -d '{"msgEncrypt":"qguoHOFLPNPuUBIMwd+DJXzZzU0npUmwsdNpOthzir8mbql0uPEuBps873GSIc6Z","nonce":"8d1e06d655df433bb8363877ad35fc70","signature":"f6f8b7088037ec7fa06c42965c0efaf8a19f9c14","timestamp":"1625486567366"}' -X POST http://localhost:8080/lottery/mobile
```

**PHP示例代码：**
```php
	$encodingKey = '';
	$encryptMsg = '';
	$encryptMsg = base64_decode($encryptMsg);
	$aesKey = base64_decode($encodingKey);
	$method = 'AES-256-CBC';
	$iv = substr($aesKey, 0, 16);
	$decryptMsg = openssl_decrypt($encryptMsg, $method, $aesKey, OPENSSL_RAW_DATA, $iv);
	var_dump($decryptMsg);
	die;
```
**注意**

- 请求方式由form形式改为json形式，已对接的公司保持原请求方式不变，如需改变请求方式，请提前告知对接人，以防对您的业务产生影响。

- [签名失败问题参考](https://hc.eqxiu.cn/doc/12/ "签名失败问题参考")

## 配置推送地址
[参见配置指南](https://hc.eqxiu.cn/doc/206/#h2-u6570u636Eu63A8u9001u914Du7F6E "参见数据推送配置")

## 配置回调密钥
EncodingKey为发送内容加解密的key，长度固定43个字符(英文大小写以及数字组成)，设置或修改见下图。
![](/media/202304/2023-04-25_133309_0132110.7463557394394797.png)

## 常用推送事件
[参见公共事件](https://hc.eqxiu.cn/doc/16/ "参见公共事件")