1. 第三方集成指引
1.1. 背景介绍
此方式适用前后端分离项目，无法直接使用云助手集成sdk的情况。前提条件是，微信用户的获取需要应用自己完成
企业自建应用，希望借助云助手平台的开放能力，实现企业微信用户的同步，以及管理企业微信用户和erp用户的关联关系。从而降低集成的代价。
1、云助手企业平台负责同步企业微信用户
2、云助手企业平台负责维护企业微信和erp用户的关联关系
1.2. 如何区分自建应用是在云助手APP还是企业微信中被打开
假设自建应用的首页地址为：https://a.b.c
1、当在云助手APP中打开https://a.b.c 时云助手APP会自动在url后面追加参数__from=wzs
2、当在企业微信中打开时，用户可以在企业微信后台添加自建应用时，填入首页地址https://a.b.c?__from=wx
这样自建应用就可以通过__from参数解析到访问来源，从而实现不同的单点登录逻辑
1.3. 如果获取微信用户信息
企业微信官方文档
1.4. 集成接口
企业自建应用传入微信用户标识换取对应的erp用户信息
接口地址
https://www.fdccloud.com/api/tenant-open/get-user-by-wx?access_token=ACCESS_TOKEN
传参方式:
POST
{ "wx_user_id": "meiy02", "from":"multi_wx1" }
参数说明：
| 参数名称 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证，如何获取，请戳这里 |
| wx_user_id | 是 | 微信用户标识，应用在微信，企业微信中被打开时，由应用自行获取 |
| from | 否 | 企业微信集成方案来源标识，如果使用了云助手“集成到第三方OA”中的“企业微信集成”方案，请务必填写此参数，可选值为：multi_wx1，multi_wx2，multi_wx3.分别对应不同的企业微信，见下图 |
返回值
{
"errcode": 0,
"errmsg": "ok",
"data": {
"user_id": "124477",
"erp_user_code": "meiy02",
"erp_user_guid": "002ed02f-48f3-4242-8eb4-4c1a089275c9",
"user_name": "梅义",
"tel": "+8615671678888",
"is_disabled": "1"
}
}
企业自建应用传入用户的user_code换取对应的企业微信wx_user_id 接口地址
https://www.fdccloud.com/api/tenant-open/get-wx-user-by-user-code?access_token=ACCESS_TOKEN
传参方式:
POST
{ "user_code_list": ["meiy02","chulx"], "from":"multi_wx1" }参数说明：
| 参数名称 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证，如何获取，请戳这里 |
| user_code_list | 是 | 查询的用户user_code集合 |
| from | 否 | 企业微信集成方案来源标识，如果使用了云助手“集成到第三方OA”中的“企业微信集成”方案，请务必填写此参数，可选值为：multi_wx1，multi_wx2，multi_wx3分别对应不同的企业微信，见下图 |
返回值
{
"errcode": 0,
"errmsg": "ok",
"isComplete": 1,
"data": [
{
"user_code": "meiy02",
"wx_user_id": "zhangsan"
}
]
}