内容中台技术手册
动态与公告
公告
发布记录
接口变更记录
对接必读
产品简介
名词解释
调用方式
公共代码
公共事件
账号开通
基础集成
单点登录
访客体系打通
数据推送
授权接口
管理集成
组织模型
企业配置接口
员工管理接口
集成配置接口
部门管理接口
编辑器集成
通用
集成页面
作品接口
统计数据接口
行为画像接口
传播脉络接口
模板接口
素材接口
分组接口
多人分发接口
作品共享接口
编辑器公共事件
黑名单管理
访客信息接口
互动
互动接口
活动参与信息接口
互动事件
自定义活动逻辑(抽奖等)
积分、权益体系集成
奖品库集成
互动任务
电子兑奖码
互动活动配置同步
地址库对接
活动白名单
收货地址自定义提交
表单
自定义表单提交
表单默认值自动填充
表单回传数据
表单选项数据结构
嵌入第三方页面
表单接口
H5
自定义下拉表单组件
任务组件
动态替换作品元素
H5接口
任务组件(新)
自定义js脚本(新)
渲染组件相关接口
数据集成
H5事件
留资玩法
长页
海报
基于模板生成图片
对接素材美化和编辑功能
海报事件
视频
服务集成
短信服务集成
素材库集成接口
自定义JS集成
审批工作流集成
红包服务集成
收款配置-小程序对接
移动端集成
Android SDK集成
iOS SDK集成
平台集成
集成申请
用户组织架构
平台接口
配置指南
企业配置
集成配置
商户号配置
最佳实践
年度总结H5
微信小程序嵌入H5
支付宝小程序嵌入H5
基于模板动态生成图片
跳转小程序页面
PC大转盘抽奖使用方法
私域分享增加权益
微信小程序对接互动默认商户号红包
常见问题
-
+
数据推送
> 通过实时或近实时将在易企秀侧产生的业务数据(如表单、访客数据等)推送给企业端,方便企业产品进行二次开发或数据留存。 ## 集成步骤 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" } ``` ### 业务数据示例 ``` { "eventId": "1727sdfcdb3d044DFs965344263dbe89w", "currentUrl": "https://hnpicc.eqxiu.cn/gs/ALD661Jr?mixCreationId=21470&embedType=mix", "code": "ALD661Jr", "corpId": "d727c5cdb3d044f39965344263dbe39e", "userIndex": 5497, "di": "bbc77f97-35d2-47f6-ab1d-ac190ec7851b", "benefitUrl": "", "mediaCategroy": "", "customerInfo": { "thirdUserId": "654448ed1233486d90acb03b87f0ba4c", "appIdType": 0, "corpId": "d727c5cdb3d044f39965344263dbe39e", "headImgUrl": "https://asset.eqxiu.cn/common/default-head-img.png", "nickName": "符才伟", "openId": "654448ed1233486d90acb03b87f0ba4c", "unionId": "xxxxxxx", "id": 67903, "type": 3, "encodeId": "0cf66ffa01f5ea20d2d8247227b1cc8e" }, "ua": { "os": "Mac OS X (iPhone)", "ip": "10.0.20.10", "browser": "Apple WebKit", "region":{"province":"四川","country":"中国","city":"成都"}, "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 MicroMessenger/8.0.16(0x1800103f) NetType/WIFI Language/en", "device": "Mobile" }, "type": "hd", "title": "海南人保财险2022新年礼", "viewDur": 58279, "benefitOpen": 0, "id": 21470, "creationId": 21470, "mediaCode": "", "status": 2 } ``` ### 字段说明 | 字段 | 类型 | 说明 | | --- | --- | --- | | eventId | String | 事件Id,可用与重复校验 | | corpOpenId | String | 企业openId【平台使用】 | | currentUrl | String | 当前页面地址,访客系统均携带,可以分析自带参数 | | eventType | String | 事件类型,[查看事件列表](https://hc.eqxiu.cn/doc/16/) | | createTime | String | 事件发生的时间格式如【2021-10-12 20:19:19】 | | creationId | Long | 作品ID | | type | String | 作品类型 | | corpId | String | 所属企业ID | | title | String | 标题 | | cover | String | 作品封面 | | startTime | String | 开始时间,格式为 yyyy-mm-dd HH:MM:ss | | endTime | String | 结束时间,格式为 yyyy-mm-dd HH:MM:ss | | code | String | code标识 | | di | String | 【作品预览页面事件必传】用户唯一标识,当用户未授权时,不存在customer信息,可根据此字段区分用户 | | ua | Object | 浏览器客户端信息,ua对象增加了地域参数,访客相关事件均有 | | ua.region | Object | 对IP地址的地域解析,部分IP解析不到可能不存在,或者省市部分值为"-"标识,为部分字段没有解析到 | | customerInfo | Object | 访客信息,访客事件才有 | ### 加密方法说明 - 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/ "参见公共事件")
will
Aug. 14, 2024, 5 p.m.
9226
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码