访客体系打通

>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%2Fv%2F28280%3Fcc%3DTZ1bBRtX](https://muc.eqxiu.com/usercenter/login?corpOpenId=null&creationId=28280&creationType=hd&redirectUri=https%3A%2F%2Feqs.eqxiu.cn%2Fv%2F28280%3Fcc%3DTZ1bBRtX "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](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:unionId | 否 | String | 微信或其他第三方渠道 unionId |
| obj:mobile | 否 | String | 手机号明文，11位数字 |
| obj:mobileCipher | 否 | String | 手机号密文 |
| obj:encryptionMethod | 否 | String |  加密方式：MD5、SHA1 |
| obj:state | 否 | String | 扩展参数，返回后在访客明细可以查看和导出 |
| obj:registerTime | 否 | Long | 注册时间，时间戳ms |

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

```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"
    }
}

```

![](/media/202601/2026-01-30_094658_2197680.1919532369367738.png)

## 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地址：