Phân trang

Trong hướng dẫn này, chúng ta sẽ tìm hiểu cách làm việc với các phản hồi phân trang khi truy vấn Fystack API. Theo mặc định, các phản hồi dạng danh sách giới hạn ở 20 kết quả. Bạn có thể yêu cầu tối đa 1000 mục bằng cách thêm tham số limit. Nếu bạn đang dùng một trong các thư viện client chính thức của Fystack API, bạn không cần bận tâm về phân trang vì việc này đã được xử lý tự động.

Khi một phản hồi API trả về danh sách đối tượng, bất kể số lượng bao nhiêu, phân trang đều được hỗ trợ. Trong các phản hồi phân trang, các đối tượng được lồng trong thuộc tính data. Bạn có thể dùng các tham số truy vấn offset và limit để duyệt qua các trang.

Ví dụ phân trang bằng offset

Trong ví dụ này, chúng ta yêu cầu trang đầu tiên của danh sách mạng lưới với giới hạn 10 mục. Bạn có thể di chuyển giữa các trang bằng cách điều chỉnh giá trị offset. Ví dụ, để lấy trang thứ hai, bạn dùng offset=10 khi limit là 10.

Name
offset
Type
integer
Description
Số mục cần bỏ qua trước khi bắt đầu lấy tập kết quả.
Name
limit
Type
integer
Description
Giới hạn số mục trả về trên mỗi trang. Giá trị tối đa là 1000.

Pagination using cURL

curl -G https://api.fystack.io/api/v1/networks \
  -d offset=0 \
  -d limit=10

Paginated response

{
  "data": [
    {
      "id": "WAz8eIbvDR60rouK",
      // ...
    },
    {
      "id": "hSIhXBhNe8X1d8Et"
      // ...
    },
    {
      "id": "fbwYwpi9C2ybt6Yb"
      // ...
    }
    // ... 7 more items
  ]
}