Skip to main content

​
分頁參數

所有回傳列表的端點都支援分頁。使用以下查詢參數控制分頁行為：
參數類型預設值說明
pageinteger1頁碼，從 1 開始
per_pageinteger20每頁筆數，最大 100

​
範例

# 取得第 2 頁，每頁 50 筆
curl -X GET "https://api.zangsho.com/v1/customers?page=2&per_page=50" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
回應格式

分頁回應包含 data 陣列與 meta 物件： 
{
  "data": [
    {
      "id": 1,
      "email": "wang.xiaoming@example.com",
      "name": "王小明",
      "created_at": "2026-01-15T08:00:00Z"
    },
    {
      "id": 2,
      "email": "chen.meiling@example.com",
      "name": "陳美玲",
      "created_at": "2026-01-16T09:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 5,
    "per_page": 20,
    "total": 98
  }
}

​
meta 欄位說明

欄位類型說明
current_pageinteger目前頁碼
last_pageinteger最後一頁頁碼
per_pageinteger每頁筆數
totalinteger總筆數

​
遍歷所有頁面

以下範例展示如何遍歷所有分頁資料： 
async function fetchAllCustomers(token) {
  const customers = [];
  let page = 1;
  let lastPage = 1;

  do {
    const response = await fetch(
      `https://api.zangsho.com/v1/customers?page=${page}&per_page=100`,
      {
        headers: {
          'Authorization': `Bearer ${token}`,
          'Accept': 'application/json'
        }
      }
    );

    const result = await response.json();
    customers.push(...result.data);

    lastPage = result.meta.last_page;
    page++;
  } while (page <= lastPage);

  console.log(`共取得 ${customers.length} 位客戶`);
  return customers;
}
  • 使用 per_page=100（最大值）可以減少請求次數
  • 注意頻率限制，大量分頁請求時適當加入延遲
  • 如果只需要確認總筆數，可以只請求 per_page=1 並讀取 meta.total