反馈已提交

网络繁忙

API取数-获取企业微信人员信息

  • 文档创建者:Roxy
  • 历史版本:12
  • 最近更新:Wendy123456 于 2024-06-06
  • 本文档示例由广州医软智能科技有限公司提供,在此特别鸣谢。

    注:该示例为从企业自建应用中使用接口取数的步骤,如果只想要使用通讯录同步获取 userid 和 department 数据,可以参考:API取数-使用通讯录同步获取企业微信userid和部门

    1. 概述

    1.1 应用场景

    公司内部使用企业微信,行政部门需要将公司所有在职人员的信息进行统计,以供其他企业业务系统作为基础信息使用。

    需要将在职人员的姓名、部门、职位、userid、手机号、性别、邮箱,这些信息取数至指定数据库中。

    1.2 接口信息

    为了获取部门所有人员信息,可以使用 读取成员 接口,而该接口需要使用 userid 作为参数,因此需要使用 获取部门成员 接口,获取返回值 userid;

    而使用 获取部门成员 接口,需要 department_id 参数,因此需要使用 获取部门列表 接口,返回部门 id 数值,如下图所示:

    1.3 实现思路

    步骤一:获取access_token:使用企业微信接口获取 access_token 作为后续的调用其他接口的登录凭证,并使用「参数赋值」节点将获取的 token 值作为参数传递给后续步骤接口使用。

    步骤二:获取部门id:使用企业微信接口 获取部门列表 获取部门 id;并使用「参数赋值」节点将部门 id 作为参数传递给后续步骤「获取userid」接口使用。

    步骤三:获取 userid 并落库:使用企业微信接口 获取部门成员 ,通过「循环容器」遍历步骤二中获取的所有「部门id」获取 userid,并将获得的 userid 数据落库至临时数据表中。

    步骤四:将 userid 作为参数输出:使用「参数赋值」将步骤三中落库的 userid 数据取出并作为参数传递给后续步骤的「获取人员信息」接口使用。

    步骤五:获取企业人员信息并落库:使用企业微信接口 读取成员,通过「循环容器」节点遍历步骤四种的所有「userid」获取企业人员信息,并将数据取至数据库。

    用到的企业微信接口:获取access_token获取部门列表获取部门成员读取成员

    1.4 任务展示

    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如下图所示:

    注:其中corpid和corpsecret参数值获取方式可以参考接口文档中 获取应用接口凭证教程

    点击「数据预览」即可看到获取的 access_token,如下图所示:

    2.1.2 将 access_token 设置为参数

    为了便于后续其他接口使用获取到的 token 值,因此将其设置为参数。

    点击「输出参数」设置参数名为 token,将 access_token 设置为参数,如下图所示:

    2.2 获取所有部门id并设置为参数

    通过 获取部门列表 接口,获取所有的部门 id 并将部门 id 作为参数传递给「获取 userid」步骤中的api使用。

    新增「参数赋值」节点,在节点信息中可以修改名称,选择数据源类型为「API」,将企业微信接口 获取部门列表 url 和参数写入对应位置:https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token=${token},并取出department 数组,如下图所示:

    注:access_token 参数值使用 2.1 节输出的 token 参数。

    点击「数据预览」,即可查看获取到的所有部门id、部门名称等数据,如下图所示

    将获取到的所有部门id 作为参数输出,设置参数名为「id」,如下图所示:

    2.3 获取所有 userid 并输出至数据库

    由于获取所有 userid 数据接口 获取部门成员 需要使用参数 access_token 和 department_id,因此需要使用循环容器,将 2.2 节获取的部门id 遍历并给 获取部门成员 接口使用。

    新建「循环容器」节点,选择遍历对象为「id」,并修改循环限制次数,如下图所示:

    接下来即可使用 获取部门成员 接口取出所有 userid 数据。

    由于接口返回的数据为 json 格式,为了便于取出数据后的数据解析,使用「数据转换」,拖入「API输入」并输入url和参数:https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token=${token}&department_id=${id},其中 access_token 和 department_id 参数分别使用了 2.1 节和 2.2 节获取并输出的参数值,如下图所示:

    点击「数据预览」即可看到取出的包含 userid 的部门成员数据,如下图所示:

    使用「JSON解析」将获取的 JSON 格式数据解析,并选取 userid ,如下图所示:

    将解析后的 userid 数据输出至指定的数据库,以供后续将 userid 作为参数使用接口取出企业人员信息,同时使用比对字段,在数据库中更新用户 userid 新增和修改数据,如下图所示:

    输出的 userid 数据表如下图所示:

    1717662920351795.png

    2.4 将 userid 作为参数输出

    由于 读取成员 接口需要使用 userid 参数,因此我们将 2.3 节取出至数据库的 userid 设置为参数,以便后续遍历该参数取出所有成员信息。

    新建「参数赋值」节点,取出 userid 数据,如下图所示:

    将其设置为参数,参数名 userid,如下图所示:

    2.5 获取所有人员信息

    使用 读取成员 接口,在循环容器中遍历 userid ,依次取出所有的人员信息。

    新建「循环容器」节点,设置循环次数,并选择遍历对象为上一步创建的参数「userid」,如下图所示:

    由于 读取成员 接口返回值为 JSON 格式,因此使用「数据转换」节点,便于接口取数后对人员信息数据进行解析。

    将「数据转换」节点拖入循环容器中,新建「API 输入」,输入读取成员接口 URL 和参数:https://qyapi.weixin.qq.com/cgi-bin/user/get?access_token=${token}&userid=${userid},如下图所示:

    新增 JSON 解析,将取出的 JSON 格式人员信息解析并选择需要的字段,如下图所示:

    然后使用「DB表输出」将取出的人员信息输出至指定数据库中,如下图所示:

    2.6 效果查看

    取出的所有企业人员信息如下图所示:

    12.png


    附件列表


    主题: 数据开发
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持