内容中台技术手册
动态与公告
公告
发布记录
接口变更记录
对接必读
产品简介
名词解释
调用方式
公共代码
公共事件
账号开通
基础集成
单点登录
访客体系打通
数据推送
授权接口
管理集成
组织模型
企业配置接口
员工管理接口
集成配置接口
部门管理接口
编辑器集成
通用
集成页面
作品接口
统计数据接口
行为画像接口
传播脉络接口
模板接口
素材接口
分组接口
多人分发接口
作品共享接口
编辑器公共事件
黑名单管理
访客信息接口
互动
互动接口
活动参与信息接口
互动事件
自定义活动逻辑(抽奖等)
积分、权益体系集成
奖品库集成
互动任务
电子兑奖码
互动活动配置同步
地址库对接
活动白名单
收货地址自定义提交
表单
自定义表单提交
表单默认值自动填充
表单回传数据
表单选项数据结构
嵌入第三方页面
表单接口
H5
自定义下拉表单组件
任务组件
动态替换作品元素
H5接口
任务组件(新)
自定义js脚本(新)
渲染组件相关接口
数据集成
H5事件
留资玩法
长页
海报
基于模板生成图片
对接素材美化和编辑功能
海报事件
视频
服务集成
短信服务集成
素材库集成接口
自定义JS集成
审批工作流集成
红包服务集成
收款配置-小程序对接
移动端集成
Android SDK集成
iOS SDK集成
平台集成
集成申请
用户组织架构
平台接口
配置指南
企业配置
集成配置
商户号配置
最佳实践
年度总结H5
微信小程序嵌入H5
支付宝小程序嵌入H5
基于模板动态生成图片
跳转小程序页面
PC大转盘抽奖使用方法
私域分享增加权益
微信小程序对接互动默认商户号红包
常见问题
-
+
活动白名单
> 某些活动需要限制某些或者某种类型的用户访问,可以使用该功能。支持导入名单和通过接口动态获取名单两种方式。 ## Excel导入 根据不同的授权方式导入可参与活动的白名单用户: 1. 公众号授权:openid 2. 手机授权:手机号 3. 自定义授权:访客userId ![](/media/202305/2023-05-23_111718_6451550.9477373106181214.png) ## 自定义接口 Excel只能导入固定的白名单,并且只能限制到用户。如果有动态白名单需求,比如根据用户身份、标签等限制访问,则可以通过自定义接口满足。 ### 使用步骤 1. 配置白名单接口,控制台-集成管理-自定义白名单。可配置多个接口,多个接口都会在编辑器展示。 ![](/media/202305/2023-05-23_100323_1000800.09931842531758661.png) ![](/media/202305/2023-05-23_110713_5234940.6207140841324507.png) (1)接口地址(标签列表):用于在编辑器显示所有可供选择的标签列表。 (2)接口地址(查询用户标签):用于用户参与活动时查询当前用户所属标签,判断该用户是否在活动白名单内。 2. 配置活动 如果不选则表示都允许参与活动,多个接口只要符合一个条件即可参与活动。 ![](/media/202305/2023-05-23_111631_9334210.29004126295495647.png) 3. 用户参与活动 如果不符合参与条件则会提示“很遗憾,您不符合活动的参与条件请咨询主办方了解活动规则!” <img src="/media/202305/2023-05-23_101420_4490660.16374702280153397.png" width="30%" height="30%"> ### 接口规范 #### 标签列表 - 接口描述:查询标签列表 - 请求方式:POST - Content-Type:application/json - 请求参数 | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | | timestamp | 必须 | String | 请求时的时间戳 | | nonce | 必须 | String | 随机字符串 | | signature | 必须 | String | 请求签名 | | msgEncrypt | 必须 | String | 加密后的消息 | - msgEncrypt内容如下: | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | | creationId | 必须 | Int | 活动id | | corpOpenId | 否 | String | 企业openId,平台型企业使用 | - 返回参数 | 字段 | 是否必须 | 类型 | 说明 | | --- | --- | --- | --- | | code | 是 | String | 标签code,标识用户标签的唯一性 | | name | 是 | String | 标签名称 | - 返回示例 ```json { "success": true, "code": "200", "msg": null, "obj": null, "map": null, "list": [ { "code": "001", "name": "黄金" }, { "code": "002", "name": "钻石" }, { "code": "003", "name": "王者" } ] } ``` #### 查询用户标签 - 接口描述:查询用户标签 - 请求方式:POST - Content-Type:application/json - 请求参数 | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | | timestamp | 必须 | String | 请求时的时间戳 | | nonce | 必须 | String | 随机字符串 | | signature | 必须 | String | 请求签名 | | msgEncrypt | 必须 | String | 加密后的消息 | - msgEncrypt内容如下: | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | | creationId | 必须 | Int | 活动id | | openId | 否 | String | 用户id,自定义授权的userId或者微信授权的openId | | mobile | 否 | String | 手机号,手机号授权 | | corpOpenId | 否 | String | 企业openId,平台型企业使用 | - 返回参数 | 字段 | 是否必须 | 类型 | 说明 | | --- | --- | --- | --- | | list | 是 | Array | 用户所拥有标签的集合 | - 返回示例 ```json { "success": true, "code": "200", "msg": null, "obj": null, "map": null, "list": ["001", "002"] } ``` #### 查询作品配置的白名单列表 - 接口描述:查询作品配置的白名单列表 - 请求方式:GET - Content-Type:application/json - 接口地址:/api/v1/editor/hd/whitelist?token=TOKEN - 请求参数 | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | | creationId | 必须 | Long | 作品id | - 返回参数 | 字段 | 是否必须 | 类型 | 说明 | | --- | --- | --- | --- | | configList | 是 | Array | 作品配置的白名单列表 | | configId | 是 | Long | 白名单ID | | whiteList | 是 | Array | 作品白名单对应的标签 | - 返回示例 ```json { "success": true, "code": "200", "msg": null, "obj": { "configList": [ { "configId": 10001, "whiteList": [ "001" ] }, { "configId": 10002, "whiteList": [ "002" ] } ] }, "map": null, "list": null, "details": null } ```
旭
Sept. 24, 2024, 3:09 p.m.
2604
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码