การแบ่งหน้า

Endpoint ที่ส่งคืนรายการจะแบ่งหน้าข้อมูล แพลตฟอร์มมี สอง รูปแบบการแบ่งหน้าตามประวัติ โดยรูปแบบที่ใช้จะระบุไว้ที่ Endpoint ใน เอกสารอ้างอิงแบบ Interactive

รูปแบบ 1 — Offset และ X-Total-Count

การแบ่งหน้าแบบ Offset แบบดั้งเดิม คำร้องรับ Query Parameter limit (ขนาดหน้า) และ offset (จำนวนระเบียนที่ข้ามไป):

curl -H "Authorization: Bearer mbp_YOUR_TOKEN" "https://your-domain/api/bots/BOT_ID/subscribers?limit=50&offset=100"

จำนวนระเบียนทั้งหมดจะส่งคืนใน Response Header X-Total-Count ใช้ค่านี้คำนวณจำนวนหน้า: เลื่อนหน้าโดยเพิ่ม offset ทีละ limit จนกว่า offset จะมากกว่าค่า X-Total-Count Body ของการตอบกลับคือ Array ของรายการในหน้าปัจจุบัน

รูปแบบ 2 — Cursor แบบ before และ has_more

การแบ่งหน้าแบบ Cursor สำหรับ Feed ที่เรียงตามเวลา (เช่น ข้อความในการสนทนา) คำร้องรับ limit และ Cursor before ที่เป็น Optional — ตัวระบุหรือเครื่องหมายของรายการสุดท้ายที่ได้รับแล้ว:

curl -H "Authorization: Bearer mbp_YOUR_TOKEN" "https://your-domain/api/bots/BOT_ID/users/USER_ID/dialog?limit=50&before=CURSOR"

การตอบกลับมีหน้าของรายการและ Flag has_more หาก has_more เป็น true ให้ส่งคำร้องซ้ำโดยส่ง Cursor ของรายการสุดท้ายที่ได้รับใน before เมื่อ has_more เป็น false นั่นคือหน้าสุดท้ายแล้ว

การเลือกรูปแบบ

คุณไม่ได้เลือกรูปแบบ — Endpoint เป็นผู้กำหนด รายการประเภทอ้างอิงมักใช้ Offset และ X-Total-Count ส่วน Feed ตามเวลาใช้ Cursor before และ has_more ตรวจสอบหน้า Endpoint ใน เอกสารอ้างอิง เสมอ

ขั้นตอนถัดไป