内容中台技术手册
动态与公告
公告
发布记录
接口变更记录
对接必读
产品简介
名词解释
调用方式
公共代码
公共事件
账号开通
基础集成
单点登录
访客体系打通
数据推送
授权接口
管理集成
组织模型
企业配置接口
员工管理接口
集成配置接口
部门管理接口
编辑器集成
通用
集成页面
作品接口
统计数据接口
行为画像接口
传播脉络接口
模板接口
素材接口
分组接口
多人分发接口
作品共享接口
编辑器公共事件
黑名单管理
访客信息接口
互动
互动接口
活动参与信息接口
互动事件
自定义活动逻辑(抽奖等)
积分、权益体系集成
奖品库集成
互动任务
电子兑奖码
互动活动配置同步
地址库对接
活动白名单
收货地址自定义提交
表单
自定义表单提交
表单默认值自动填充
表单回传数据
表单选项数据结构
嵌入第三方页面
表单接口
H5
自定义下拉表单组件
任务组件
动态替换作品元素
H5接口
任务组件(新)
自定义js脚本(新)
渲染组件相关接口
数据集成
H5事件
留资玩法
长页
海报
基于模板生成图片
对接素材美化和编辑功能
海报事件
视频
服务集成
短信服务集成
素材库集成接口
自定义JS集成
审批工作流集成
红包服务集成
收款配置-小程序对接
移动端集成
Android SDK集成
iOS SDK集成
平台集成
集成申请
用户组织架构
平台接口
配置指南
企业配置
集成配置
商户号配置
最佳实践
年度总结H5
微信小程序嵌入H5
支付宝小程序嵌入H5
基于模板动态生成图片
跳转小程序页面
PC大转盘抽奖使用方法
私域分享增加权益
微信小程序对接互动默认商户号红包
常见问题
-
+
访客体系打通
>1. 实现营销访客与企业自有用户关联 >1. 营销落地页可以使用企业用户数据 # 使用说明 1. 根据规范开发自定义授权页、以及获取用户信息接口 1. 登录控制台,服务集成模块,添加自有App集成配置,参见[自主用户系统配置](https://hc.eqxiu.cn/doc/206/ "自主用户系统配置") # 对接方式 一共有4中方式:授权页方式、code接口方式、参数方式、仅code方式。 ## 1. 授权页方式【推荐】 ### 交互流程图 ![](/media/202205/2022-05-26_163030_339579.png) ### 自定义授权页开发规范 - 页面业务逻辑: 1. 检测当前环境是否为自定义App,如果不是检测本地是否已安装App,唤起App或引导下载 1. 页面访问企业自有服务端,服务端生成临时code【一次使用有效】,code与当前登陆用户信息绑定,返回code。 1. 页面获取code 后发起重定向,重定向地址为redirectUrl&code=服务端生成的code,redirectUrl 为授权页的入参,即原作品链接地址。 - 注意: 重定向至第三方授权页请求**示例**: [https://muc.eqxiu.com/usercenter/login?corpOpenId=null&creationId=28280&creationType=hd&redirectUri=https%3A%2F%2Feqs.eqxiu.cn%2Fgs%2FTZ1bBRtX%3Fe_ff_i%3D220110151](https://muc.eqxiu.com/usercenter/login?corpOpenId=null&creationId=28280&creationType=hd&redirectUri=https%3A%2F%2Feqs.eqxiu.cn%2Fgs%2FTZ1bBRtX%3Fe_ff_i%3D220110151 "https://muc.eqxiu.com/usercenter/login?corpOpenId=null&creationId=28280&creationType=hd&redirectUri=https%3A%2F%2Feqs.eqxiu.cn%2Fgs%2FTZ1bBRtX%3Fe_ff_i%3D220110151") - 携带参数: | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | | corpOpenId | 否 | string | 平台型企业会携带,作品所属企业 | | creationId | 是 | Number | 作品id | | creationType | 是 | string | 作品类型,hd:互动,lc:长页,design:海报,h5:h5,form:表单 | | redirectUri | 是 | string | 发起授权的作品链接,授权后需跳转此地址 | ### 获取用户信息接口规范 - 方法类型:GET - 入参 | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | | code | 必填 | string | 企业服务生成的临时code,注意code不要包含=、/、\、&等特殊字符 | | XXX |非必填 | string | 动态字段,地址栏参数集合,如果企业需要其他字段,可以通过这个实现,例如在作品访问地址上拼接:customArgs1=111,该参数会出现 | |creationType | 必填 | string | 作品类型 | - 返回值 | 参数名 | 是否必须 | 参数类型 | 参数说明 | | --- | --- | --- | --- | | success | 必填 | boolean | 请求状态 | | code | 必填 | int | 请求状态码,200成功, | | msg | 必填 | string | 错误消息,正确是返回“ok” | | obj:userId | 必填 | string | 用户唯一id,**最长支持64位** | | obj:channelKey | 否 | String | 渠道编码;微信认证方式返回值为wx;手机号授权方式返回值为mo ;小程序授权方式返回值:ori_wxmp;APP授权方式返回值:ori_app;PC授权方式返回值:ori_pc (请根据您的实际情况返回值) | obj:nickName | 否 | string | 姓名或呢称 | | obj:headImg | 否 | string | 头像 | | obj:sex | 否 | int | 性别,1男,2女 | | obj:mobile | 否 | String | 手机号 | | obj:state | 否 | String | 扩展参数,返回后在访客明细可以查看和导出 | ```json { success:true, code:"200", msg:"ok", obj:{ userId:"32f909e22ba842fe09a192", // 最长支持64位 nickName:"李XX", headImg:"https://xxx.xx.xx/img/abcdef.jpg", sex:1, mobile:"13866668888", channelKey:"ori_custom" } } ``` ## 2. code接口方式【推荐】 ### 交互流程图 ![](/media/202205/2022-05-26_163047_169719.png) ### 获取用户信息接口规范 见“授权页方式” ## 3. 参数方式【不推荐】 ### 交互流程图 ![](/media/202205/2022-05-26_163058_246124.png) 此方式无需接口,code为访客唯一标识,不能是临时的。==不安全== 。code最长支持==64位== ## 4. 仅code方式【不推荐】 ### 交互流程图 ![](/media/202205/2022-05-26_163110_682505.png) 此方式与“参数方式基本一致”,仅参数区别,==不安全==。code最长支持==64位== ### 示例代码 github地址:
will
Nov. 7, 2024, 5:23 p.m.
11145
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码