访客体系打通

实现营销访客与企业自有用户关联
营销落地页可以使用企业用户数据

使用说明

根据规范开发自定义授权页、以及获取用户信息接口
登录控制台，服务集成模块，添加自有App集成配置，参见自主用户系统配置

对接方式

一共有4中方式：授权页方式、code接口方式、参数方式、仅code方式。

1. 授权页方式【推荐】

交互流程图

自定义授权页开发规范

页面业务逻辑：

检测当前环境是否为自定义App，如果不是检测本地是否已安装App，唤起App或引导下载
页面访问企业自有服务端，服务端生成临时code【一次使用有效】，code与当前登陆用户信息绑定，返回code。
页面获取code 后发起重定向，重定向地址为redirectUrl&code=服务端生成的code，redirectUrl 为授权页的入参,即原作品链接地址。

注意：
重定向至第三方授权页请求示例：

https://muc.eqxiu.com/usercenter/login?corpOpenId=null&creationId=28280&creationType=hd&redirectUri=https%3A%2F%2Feqs.eqxiu.cn%2Fv%2F28280%3Fcc%3DTZ1bBRtX

返回易企秀作品链接示例:
https://eqs.eqxiu.cn/v/28280?cc=TZ1bBRtX&code=xxxxxxx

携带参数：

参数名	是否必须	参数类型	参数说明
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:openId	否	String	微信或其他第三方渠道 openId
obj:mobile	否	String	手机号明文
obj:mobileCipher	否	String	手机号密文
obj:encryptionMethod	否	String	加密方式：MD5、SHA1
obj:state	否	String	扩展参数，返回后在访客明细可以查看和导出

注意：当我们需要使用第三方风控服务时，必须要返回手机号或openId。

{
    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接口方式【推荐】

交互流程图

获取用户信息接口规范

见“授权页方式”

3. 参数方式【不推荐】

交互流程图

此方式无需接口，code为访客唯一标识，不能是临时的。不安全。code最长支持64位

4. 仅code方式【不推荐】

交互流程图

此方式与“参数方式基本一致”，仅参数区别，不安全。code最长支持64位

示例代码

github地址：