<aside> <img src="/icons/drafts_gray.svg" alt="/icons/drafts_gray.svg" width="40px" />

• 當 API 回傳的資料太多時，例如: 需呼叫 GET /v1/orders 取得所有訂單資料，商家的訂單數總共有 2717 筆，CYBERBIZ 的 API 會做 pagination，一次 API 呼叫最多回傳 50 筆資料。
• 可以透過 page、 per_page、 offset 3 個參數，來取得所有資料。
• API 的 response header 裡會有 X-Page 、X-Per-Page 、X-Offset 、X-Total 、X-Total-Pages 、X-Next-Page 這些 header，會告知這次 API 回傳的資料的內容所在位置。 </aside>

API Request 參數

page

• 意思：當前頁碼 (從 1 開始計算)
• 用途：指定要顯示的頁數
• 例子：如果 page = 2，表示顯示第 2 頁的內容
• 預設值：1

per_page

• 意思：每頁顯示的項目數量
• 用途：定義每頁應包含的記錄數量
• 例子：如果 per_page = 20，表示每頁顯示 20 筆資料
• 預設值：50
• 最大值：50

offset

• 意思：偏移量，即從資料集的哪個位置開始獲取資料。也就是略過前面的 offset 筆資料
• 用途：跳過前面的 N 筆記錄，直接從指定位置開始獲取資料。當同時使用 offset、 page 和 per_page 時，API 回傳的資料，就是從第 offset + (page - 1) * per_page + 1 筆開始
• 例子：如果 offset = 40，表示跳過前 40 筆資料，從第 41 筆開始獲取
• 例子：如果 offset = 0，表示不跳過任何資料，從第一筆資料開始獲取
• 預設值：0