การแบ่งหน้าแบบเคอร์เซอร์

การแบ่งหน้าแบบเคอร์เซอร์

การแบ่งหน้าแบบเคอร์เซอร์เป็นกลยุทธ์การแบ่งหน้าที่ใช้โทเค็นทึบ ("เคอร์เซอร์") เพื่อระบุตำแหน่งในชุดผลลัพธ์ แทนการพึ่งพาออฟเซ็ตเชิงตัวเลข เช่น page=2 หรือ offset=100 ผู้ใช้ส่งเคอร์เซอร์กลับไปยังเซิร์ฟเวอร์ (ตัวอย่างเช่นผ่านพารามิเตอร์ after_cursor) เพื่อขอหน้าถัดไป และเซิร์ฟเวอร์จะส่งเคอร์เซอร์ใหม่สำหรับหน้าต่อไปในคำตอบ

ในบริบท

Endpoint Gamma /markets ของ Polymarket ต้องการการแบ่งหน้าด้วยเคอร์เซอร์: การเรียกต้องใช้ค่า after_cursor ที่ส่งกลับจากคำขอก่อนหน้า แทนการใช้พารามิเตอร์ offset วิธีแบบ keyset นี้ช่วยปรับปรุงประสิทธิภาพและความสอดคล้องบนชุดผลลัพธ์ขนาดใหญ่หรือที่มีการอัปเดตบ่อย เพราะเซิร์ฟเวอร์สามารถดำเนินการต่อจากตำแหน่งที่คงที่โดยไม่ต้องสแกนตั้งแต่ต้นสำหรับแต่ละหน้า Gamma จะคืนค่า next_cursor ในแต่ละการตอบกลับที่แบ่งหน้า; ให้ค่านั้นเป็น after_cursor เพื่อดึงหน้าต่อไป

ข้อสังเกตเชิงปฏิบัติ

• โทเค็นทึบ: ปฏิบัติต่อเคอร์เซอร์เป็นสตริงที่ไม่ต้องตรวจสอบ อย่าพยายามแยกวิเคราะห์หรือสร้างเคอร์เซอร์ด้วยฝั่งไคลเอ็นต์
• ไม่มีออฟเซ็ตเชิงตัวเลข: Gamma API ปฏิเสธออฟเซ็ตเชิงตัวเลข; ใช้ after_cursor สำหรับการแบ่งหน้าด้วย /markets endpoint จุดสิ้นสุดนี้รองรับ limit (สูงสุด 1000) ควบคู่กับ after_cursor
• ลำดับมีความสำคัญ: การแบ่งหน้าแบบเคอร์เซอร์ผูกกับการเรียงลำดับของคำค้น หากคุณเปลี่ยนฟิลด์การเรียง คุณอาจไม่สามารถดำเนินการต่อโดยใช้เคอร์เซอร์ก่อนหน้านี้ได้
• ไคลเอ็นต์ที่ทนทาน: บันทึกเคอร์เซอร์หากคุณตั้งใจจะดำเนินการสแกนยาว และจัดการกรณีที่เคอร์เซอร์ที่ออกก่อนหน้านี้กลายเป็นล้าสมัยหรือให้ผลลัพธ์เป็นศูนย์

ดูเพิ่มเติม

• /glossary/gamma-api