1. 概述
1.1 应用场景
API取数-获取企业微信人员信息 可以将自建应用的企业微信人员信息数据从接口中取出。
但如果用户只是想要将「通讯录同步」的企业微信人员 userid 和 department 信息从接口中取出,则可以有更简便的方式。
1.2 接口信息
可以使用 获取成员ID列表 接口直接获取用户的 userid 和 department 数据。
注:该接口仅支持通过「通讯录同步secret」调用。
1.3 任务展示
2. 操作步骤
2.1 获取 access_token 并设置为参数
2.1.1 获取access_token
获取 access_token 是调用企业微信 API 接口的第一步,相当于创建了一个登录凭证,其它的业务 API 接口,都需要依赖于 access_token 来鉴权调用者身份。
使用参数赋值节点,在节点信息中修改名称为「获取token」,选择数据源类型为「API」,将企业微信接口 获取 access_token url 和参数写入对应位置,:https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET,如下图所示:
注:corpsecret 一定要是通讯录管理secret,详情参见:通讯录管理
点击「数据预览」即可看到获取的 access_token,如下图所示:
2.1.2 将 access_token 设置为参数
为了便于后续其他接口使用获取到的 token 值,因此将其设置为参数。
点击「输出参数」设置参数名为 token,将 access_token 设置为参数,如下图所示:
2.2 获取userid和department
通过 获取成员ID列表 接口,获取所有的企业微信成员 userid 和 department。
新增「数据转换」节点,在节点信息中可以修改名称。进入数据转换编辑界面,新增API 输入算子,将企业微信接口 获取成员ID列表url 和参数写入对应位置:https://qyapi.weixin.qq.com/cgi-bin/user/list_id?access_token=${token},并取出$.dept_user 数组,如下图所示:
点击数据预览即可看到取出的 userid 和 department 数据,如下图所示:
然后可使用「DB表输出」将取出的数据输出至指定的数据库,如下图所示: