添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接
相关文章推荐
大气的针织衫  ·  API输入-分页取数- ...·  2 天前    · 
买醉的铁链  ·  The Sims 4 - 《The ...·  3 月前    · 
刚毅的花卷  ·  Transform Shapefile ...·  3 月前    · 
愤怒的佛珠  ·  android studio的 - CSDN文库·  11 月前    · 
维度
说明
取数限制

限制分页取数的次数。

  • 默认为128

  • 不能为空,限制最大值为 10000

  • 当达到循环上限时,还未满足分页结束条件,也结束分页取数,并报错

分页方式-页码

参数

  • 只能在这个「API输入算子」内使用、为算子级参数、且同名优先级最高;

  • 在单次调取API结束后,再自增;

  • 用户可在 Query 参数和Body内的各种格式下使用,与常规的参数用法无差异;

更新策略

  • 初始值:用户可配置初始值,默认为1,不能为空

  • 增长间隔:用户不能修改增长间隔,默认为1,不能为空

用户配置起始值和增长间隔后,每次循环后执行自增动作,自增逻辑为:pageNum=pageNum+增长间隔

分页结束条件

  • http status: 本次循环的API返回 http status

  • JSONPath: 本次循环的API返回body作为基础,在这个基础上通过写JSONPath获取信息(仅支持返回单个值,如果返回是数组或者JSON对象,也格式化为字符串); 当响应体的jsonPath没有时,则取空

  • requestTimes: 分页取数的循环次数, 如果在循环容器中的API输入算子,该取数次数循环容器每次循环分开计数

  • pageNum: 页码参数$pageNum

注:值可以引用参数。

分页方式- 偏移量

参数:

  • 只能在这个 API输入算子 内使用 、为算子级参数、且同名优先级最高;

  • 在单次调取API结束后,再自增;

  • 用户可在Query参数和Body内的各种格式下使用,与常规的参数用法无差异;

更新策略

  • 初始值:用户可配置初始值,默认为1,不能为空

  • 增长间隔:用户用可配置增长间隔,默认为20,不能为空

用户配置起始值和增长间隔后,每次循环后执行自增动作,自增逻辑为:offset=offset+增长间隔

分页结束条件

  • http status: 本次循环的API返回 http status

  • JSONPath: 本次循环的API返回body作为基础,在这个基础上通过写JSONPath获取信息(仅支持返回单个值,如果返回是数组或者JSON对象,也格式化为字符串); 当响应体的jsonPath没有时,则取空

  • requestTimes: 分页取数的循环次数, 如果在循环容器中的API输入算子,该取数次数循环容器每次循环分开计数

  • offset:偏移量参数$offset

注:值可以引用参数

分页方式- 游标 游标:
  • 只能在这个 API输入算子 内使用 、为算子级参数、且同名优先级最高;

  • 用于链式循环场景,每次循环后执行继承更新动作;

  • 用户可在Query参数和Body内的各种格式下使用,与常规的参数用法无差异;

更新策略

  • 默认值:默认为空,用户可输入、允许为空、支持参数引用,

  • 游标参数更新:

    • 当响应体的jsonPath没有时,则取空

    • 用户可以使用本次循环的API返回的body作为基础,在这个基础上通过写JSONPath作为更新后的值(仅支持返回单个值,如果返回是数组或者JSON对象,也格式化为字符串)

    • 注:先判断分页结束条件,再执行游标参数更新。

分页结束条件

  • http status: 本次循环的API返回 http status

  • JSONPath: 本次循环的API返回body作为基础,在这个基础上通过写JSONPath获取信息(仅支持返回单个值,如果返回是数组或者JSON对象,也格式化为字符串); 当响应体的jsonPath没有时,则取空

  • requestTimes: 分页取数的循环次数, 如果在循环容器中的API输入算子,该取数次数循环容器每次循环分开计数

  • cursor:游标参数$cursor

注:值可以引用参数

勾选了分页取数后, API 数据源其他功能说明:

功能 说明
重试 若 API 输入分页取数单次执行调用API失败,没有重试逻辑,按整个数据转换节点重试
调用频率控制 在一个任务实例中,分页取数多次调用API受「调用频率控制」控制
  • json路径

  • 将解析后的json数据展开为二维表

  • 如果API节点只配置了分页取数,将每次取数获得的json拼成一个一列N行的二维表(该二维表只有一列 responseBody

  • 如果API节点本身配置了分页取数&Json路径,将每次取数获得相应路径下的json,拼成一个一列N行的二维表(该二维表只有一列responseBody)

因为每次分页取数时获得 json 可能不一样,如果找不到相应json路径,则为空

  • 如果 API 节点本身配置了分页取数&Json 路径为「$.data」&勾选「 将解析后的JSON数据展开为二维表」,将每次取数获得相应路径下 json 进行拆列,拼成一个N列N行的二维表

因为每次分页取数时获得 json 可能不一样,每次将json展开二维表时,如果遇到新的属性,则新增列

没有相关属性的分页取数,相关列为空

返回值格式 当响应体格式为 xml 时,不支持分页取数

信息类型(参数赋值)

  • 响应体

  • 响应头

  • 状态码

如果参数赋值同时解析响应体、响应头、状态码,将每次取数获得响应拼成一个N列N行的二维表