> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/th/developers/api/pagination.md).

# การแบ่งหน้า

> ไล่ดูรายการยาวใน BoxHero API ด้วยการแบ่งหน้าแบบ cursor

endpoint ที่แสดงรายการจะส่งคืนผลลัพธ์ทีละหน้าและใช้การแบ่งหน้าแบบ cursor

## พารามิเตอร์ของคิวรี

| พารามิเตอร์ | คำอธิบาย |
| --- | --- |
| `cursor` | จุดเริ่มต้นของหน้า ส่งฟิลด์ `cursor` จากการตอบกลับก่อนหน้า ไม่ต้องใส่ในการเรียกครั้งแรก |
| `limit` | ขนาดหน้า ช่วงที่อนุญาตและค่าเริ่มต้นระบุไว้ในแต่ละ endpoint เช่น [แสดงรายการสินค้า](https://www.boxhero.io/docs/th/developers/api/reference/items/list-items) |

## การตอบกลับ

แต่ละหน้าจะมีผลลัพธ์พร้อมฟิลด์ที่ใช้ดึงหน้าถัดไป:

```json
{
  "items": [...],
  "count": 100,
  "limit": 100,
  "cursor": 1234567,
  "has_more": true
}
```

| ฟิลด์ | คำอธิบาย |
| --- | --- |
| `count` | จำนวนผลลัพธ์ในหน้านี้ |
| `limit` | ขนาดหน้าที่ใช้สำหรับหน้านี้ |
| `cursor` | ส่งค่านี้เป็นพารามิเตอร์คิวรี `cursor` เพื่อรับหน้าถัดไป เป็น `null` เมื่อไม่มีหน้าเพิ่มเติม |
| `has_more` | เป็น `true` หากมีผลลัพธ์เพิ่มเติมหลังหน้านี้ |

## การดึงข้อมูลทุกหน้า

1. เรียก endpoint ที่แสดงรายการโดยไม่ใส่ `cursor`
2. ขณะที่ `has_more` เป็น `true` ให้เรียกอีกครั้งโดยตั้ง `cursor` เป็น `cursor` จากการตอบกลับล่าสุด
3. หยุดเมื่อ `has_more` เป็น `false`

```bash
curl "https://rest.boxhero-app.com/v1/items?cursor=1234567" \
  -H "Authorization: Bearer $BOXHERO_API_TOKEN"
```

ใช้ตัวกรองที่ใช้ในการเรียกครั้งแรกให้เหมือนเดิมในทุกการเรียกถัดไป

## การเรียงลำดับ

แต่ละทรัพยากรกำหนดลำดับของตัวเอง endpoint ที่แสดงรายการส่วนใหญ่จะส่งคืนผลลัพธ์ตาม id จากน้อยไปมาก [แสดงรายการธุรกรรม](https://www.boxhero.io/docs/th/developers/api/reference/transactions/list-transactions) จะส่งคืนธุรกรรมล่าสุดก่อน (ตามเวลาธุรกรรม โดยใช้ id ตัดสินเมื่อเวลาเท่ากัน)

> **Tip**
>
> **เคล็ดลับ**: หากต้องการซิงค์สำเนาธุรกรรมของคุณให้เป็นปัจจุบัน ให้เก็บ `revision` ของแต่ละธุรกรรม เมื่อไล่ดูรายการอีกครั้ง `revision` ที่สูงขึ้นจะบอกว่าธุรกรรมนั้นถูกแก้ไขหลังจากที่คุณเห็นครั้งล่าสุด