内容中台技术手册
动态与公告
公告
发布记录
接口变更记录
对接必读
产品简介
名词解释
调用方式
公共代码
公共事件
账号开通
基础集成
单点登录
访客体系打通
数据推送
授权接口
管理集成
组织模型
企业配置接口
员工管理接口
集成配置接口
部门管理接口
编辑器集成
通用
集成页面
作品接口
统计数据接口
行为画像接口
传播脉络接口
模板接口
素材接口
分组接口
多人分发接口
作品共享接口
编辑器公共事件
黑名单管理
访客信息接口
互动
互动接口
活动参与信息接口
互动事件
自定义活动逻辑(抽奖等)
积分、权益体系集成
奖品库集成
互动任务
电子兑奖码
互动活动配置同步
地址库对接
活动白名单
收货地址自定义提交
表单
自定义表单提交
表单默认值自动填充
表单回传数据
表单选项数据结构
嵌入第三方页面
表单接口
H5
自定义下拉表单组件
任务组件
动态替换作品元素
H5接口
任务组件(新)
自定义js脚本(新)
渲染组件相关接口
数据集成
H5事件
留资玩法
长页
海报
基于模板生成图片
对接素材美化和编辑功能
海报事件
视频
服务集成
短信服务集成
素材库集成接口
自定义JS集成
审批工作流集成
红包服务集成
收款配置-小程序对接
移动端集成
Android SDK集成
iOS SDK集成
平台集成
集成申请
用户组织架构
平台接口
配置指南
企业配置
集成配置
商户号配置
最佳实践
年度总结H5
微信小程序嵌入H5
支付宝小程序嵌入H5
基于模板动态生成图片
跳转小程序页面
PC大转盘抽奖使用方法
私域分享增加权益
微信小程序对接互动默认商户号红包
常见问题
-
+
奖品库集成
> 实现中台与企业自有奖品库打通。支持奖品代码、电子兑奖码两种对接方式。 ## 奖品代码集成第三方系统 ### 功能效果 集成对接前,如下图,奖品码为手动输入 ![](/media/202207/2022-07-14_111550_471524.png) 集成对接后,如下图,奖品码选择,奖品以及奖品的库存来源于合作方 点击查询按钮会实时查询合作方接口,获取奖品信息 ![](/media/202207/2022-07-14_111957_073332.png) ### 配置接口 【应用管理】-【互动编辑器】 ![](/media/202207/2022-07-14_111202_973027.png) ![](/media/202207/2022-07-14_111411_620850.png) 在配置的接口地址上拼eqs_uid_open=1参数后,在请求该接口时header中会携带eqsUidOpen(当前员工的openId)。 ### 配置说明 |页面名称|使用说明| |---|---| |库名|用来区分配置| |奖品定义查询接口|接口地址| |奖项设置成功信息通知接口|用来通知某个奖项最后设置的数量| |对接奖品类型|可选择多个,分别在奖项选择时对应类型时,才会出现选择奖品| |是否开启|开启:配置生效,关闭:配置不生效| ### 接口规范 - 奖品定义查询接口 - 方法类型:POST - Content-Type:application/json - 接口入参 | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | | nonce | 是 | String | 随机字符串 | | timestamp | 是 | Long | 当前 UNIX 时间戳,可记录发起 API 请求的时间。例如1529223702 | | signature | 是 | String | 请求签名。 | | msgEncrypt | 是 | String | 数据明细,不同业务类型,数据格式不一样 | - msgEncrypt解密数据格式 | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | |corpOpenId|否|String|平台使用,子企业唯一标识| |prizeName|否|String|奖品模版名称,可模糊查询| |prizeCode|否|String|奖品模版代码,可模糊查询| |prizeType|是|int|奖品类型[0、礼品 1、优惠券 4、积分]| |creationId|否|long|作品ID| |pageSize|否|int|每页大小,默认20| |pageNo|否|int|第几页,默认1| - 接口返回值 | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | |code|是|String|状态码,200请求正确,其他视为失败| |msg|否|String|返回消息| |list|是|List|prizeName奖品名称<br>prizeCode 奖品代码",<br>surplus 剩余库存数(不返回该字段或者返回值为-1时表示无限库存)<br>prizeImgUrl 奖品图片链接 没有可不传<br>redemptionMethod: 兑奖方式 <br> linkType:链接类型<br>redemptionAddr: 跳转地址| |map|是|Map|count列表查询总条数| 至少包含code和msg参数。 ```json { "code": 200, "msg": "操作成功", "obj": {}, "map": { "pageNo": 1, "count": 1, "pageSize": 10, "end": true }, "list": [ { "prizeName": "奖品名称", "prizeCode": "奖品代码", "surplus": 1, // 剩余库存数, "prizeImgUrl": "https://wework.qpic.cn/wwhead/nMl9sso", "redemptionMethod": "webClaim" // 可选值webClaim: 网页兑奖,outClaim: 外部兑奖 "linkType": "webAddress" // 可选值webAddress: 网页地址,miniProNormalAdr: 小程序普通地址, miniProTabAdr: 小程序tabbar地址 "redemptionAddr": '' //跳转地址 } ] } ``` - 奖项设置成功信息通知接口 - 方法类型:POST - Content-Type:application/json - 接口入参 | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | | nonce | 是 | String | 随机字符串 | | timestamp | 是 | Long | 当前 UNIX 时间戳,可记录发起 API 请求的时间。例如1529223702 | | signature | 是 | String | 请求签名。 | | msgEncrypt | 是 | String | 数据明细,不同业务类型,数据格式不一样 | - msgEncrypt解密数据格式 | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | |prizes|是|list|奖品信息| |prizes.prizeCode|是|String|奖品代码| |prizes.prizeName|是|String|奖品名称| |prizes.prizeNum|是|int|奖品使用数量| |id|是|String|作品id| |time|是|String|使用时间| ```json { "prizes": "[{\"prizeCode\":\"prize13\",\"prizeName\":\"测试13\",\"prizeNum\":3}]", "id": "234", "time": "2024-03-06 13:50:23" } ``` ## 奖品代码人为填写 创建互动H5在设置奖项时,选择奖品或优惠券,并填写奖品代码。如下图: 奖品代码为企业奖品库的一类奖品标识,访客在中奖后,可通过此代码领取对应的奖品(会有事件推送,见下文) 此方式,奖品代码对应的奖品一般是同一种奖品。 ![](/media/202205/2022-05-26_184859_729064.png) ## 数据推送 访客用于在抽奖中奖后,中台会将访客的中奖信息进行推送,企业需要设置数据接收的地址。 数据接收地址设置方式见“[数据回传](https://hc.eqxiu.cn/doc/24/)”。 数据推送对接方式见“[数据推送](https://hc.eqxiu.cn/doc/24/)” 访客中奖数据推送格式见“[活动中奖](https://hc.eqxiu.cn/doc/52/)”
will
Nov. 7, 2024, 5:27 p.m.
5725
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码