API輸入-分頁取數

限制分頁取數的次數。

• 預設為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

注：值可以引用參數

• json路徑

• 將解析後的json資料展開為二維表

• 如果API節點只配置了分頁取數，將每次取數獲得的json拼成一個一欄N行的二維表（該二維表只有一欄 responseBody）

• 如果API節點本身配置了分頁取數&Json路徑，將每次取數獲得相應路徑下的json，拼成一個一欄N行的二維表（該二維表只有一欄responseBody）

因為每次分頁取數時獲得 json 可能不一樣，如果找不到相應json路徑，則為空

• 如果 API 節點本身配置了分頁取數&Json 路徑為「$.data」&勾選「將解析後的JSON資料展開為二維表」，將每次取數獲得相應路徑下 json 進行拆列，拼成一個N列N行的二維表

因為每次分頁取數時獲得 json 可能不一樣，每次將json展開二維表時，如果遇到新的屬性，則新增列

沒有相關屬性的分頁取數，相關列為空

資訊類型（參數指派）

• 回應體

• 回應頭

• 狀態碼