當 API 回傳的資料太多時 (例如需呼叫 GET /v1/orders 取得所有訂單資料，商家的訂單數總共有 2717 筆)，我們的 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 回傳的資料的內容所在位置。

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