API取数概述

参数赋值节点

接口取数

从企微自建应用中使用 读取成员 接口，获取部门所有人员信息

1. 获取access_token

2. 获取所有部门ID并设置为参数

3. 遍历部门ID，获取userid，将userid落库

4. userid作为参数输出

5. 遍历userid，获取人员信息

接口取数

1、参数赋值+循环容器

使用高德接口获取城市天气数据

将经纬度数据转换为中文地址

2、按日期分表，每天保存当天数据：每天数据过大，希望能每天创建一个新的数据表，保存该天数据

3、API取数-钉钉获取部门列表：接口只能获取当前部门的下一级部门基础信息，不支持获取当前部门下所有层级子部门。因此需要依次根据父部门ID循环获取子部门ID

4、API取数-使用通讯录同步获取企业微信userid和部门：使用的接口：获取成员ID列表

参数进行分组后再从接口循环取数

接口限制一次取数不能超过100，但实际场景中是超过100的

以获取企微月报打卡数据为例：

1. 获取成员ID接口需要的access_token，输出为参数

2. 获取企业微信成员 userid 和 department

3. 将 userid 分组并输出为参数

4. 准备接口所需的参数，根据成员分组批量循环取数

接口取数+MD5加密

使用MD5加密获取签名sign，从 API 接口取数

接口取数、接口参数做的操作：

• 为请求正文 Hash 摘要后再 base-16 编码的结果、

• 使用签名认证

• 使用 SparkSQL HMACSHA256函数

分页取数：按页数取数，其中接口中存在参数：

• pageIndex：数据页数

• pageSize：每一页的数据条数

4.1.3 及之后版本：

1. 将 pageSize 设置为 100，获取总页数，输出参数totalpages

2. 使用数据同步节点，从第一页开始取数，页码大于 totalpages 时，终止取数

4.1.3 之前版本：

1. 将 pageSize 设置为 100，获取总页数，输出参数totalpages

2. 使用循环容器和内置参数 loopTimes，从第一页开始取数，当循环次数 loopTimes>total_pages 时，停止执行

分页取数，接口返回值中没有总页数 total_pages，需要手动计算

请求参数：

• pageNum：分页参数，数值可自定义

• pageSize：每页数据条数，数值可自定义

返回值参数：

• totalNum：返回取出数据的总数据条数

• pageSize：返回取出数据的每页数据条数
  

分页取数，接口中没有页数相关的参数，但有：

• limit：查询的数据条数，1-100，默认为10

• data_id：上一次查询数据结果的最后一条数据的ID

1. 为了从数据库中可以获得最大 id 作为参数，先随机取出 10 条数据落库

2. 获取数据表中最大的 id 值作为参数

3. 使用 id 值，每次从接口中取 100 条数据

4. 找到每次执行的最后一行 id 值，输出为参数，若值为空，停止循环

循环执行 2-4 步骤

分页取数：按偏移量取数，接口参数如下：

• FilterString：参数中使用日期区间作为参数，获取一段时间（开始时间和结束时间）作为日期参数，取出该段时间内的数据

• StartRow：开始行索引

• Limit：每次取数的限制条数
  

以金蝶云星空销售报价单接口为例：

分页取数-按偏移量取数

分页取数：按偏移量取数，接口参数如下：

• StartRow：开始行索引

• Limit：每次取数的限制条数

返回参数：

Result.RowCount：返回所取数据的总行数

4.1.3 及之后版本，可参考：分页取数-按偏移量取数 实现

4.1.3 之前版本，可参考：API取数-以起始行数作为参数 方案实现

使用分页参数进行分页取数：

Body 参数中有分页参数 scrollid：

接口文档详情参见：根据时间窗滚动查询变动的员工与单条任职信息

分页取数+游标

Body 参数：

• cursor：分页查询的游标，最开始传0，后续传返回参数中的next_cursor值

返回参数：

• has_more：是否还有更多数据，true 为有，false 为没有

• next_cursor：下一次分页的游标（如果has_more为false，表示没有更多的分页数据）
  

分页取数+加密

分页取数，调用接口时需要携带签名参数 sign，只有当 sign 值合法时请求才会被接受

1. 使用 SHA2 加密签名 sign，并输出为参数

2. 将每页数据限制为100条，获取总页数，输出参数totalpages（该过程使用到了加密sign）

3. 使用循环容器和内置参数 loopTimes，从第一页开始取数，当循环次数 loopTimes>total_pages 时，停止执行（该过程使用到了加密sign）

嵌套循环取数

循环容器根据参数A循环取数

循环容器内，分页取数

以 慧策-WMS库存全量查询接口 取数为例：

用户希望定时任务仅在工作日运行