Cursor pagination

Cursor pagination

Cursor pagination ialah strategi penomboran yang menggunakan token samar (disebut "cursor") untuk menandakan kedudukan dalam set keputusan, berbanding bergantung pada offset berangka seperti page=2 atau offset=100. Klien menghantar semula cursor itu ke pelayan (contohnya melalui parameter after_cursor) untuk meminta halaman seterusnya. Pelayan membalas dengan cursor baru untuk halaman berikut dalam responsnya.

In context

Polymarket's Gamma /markets endpoint memerlukan penomboran berasaskan kursor: panggilan mesti menggunakan nilai after_cursor yang dikembalikan oleh permintaan sebelumnya dan bukannya parameter offset. Pendekatan gaya keyset ini meningkatkan prestasi dan konsistensi pada set keputusan yang besar atau kerap dikemas kini kerana pelayan boleh menyambung semula dari kedudukan stabil tanpa mengimbas dari permulaan untuk setiap halaman. Gamma mengembalikan next_cursor dalam setiap respons berpenomboran; gunakan nilai itu sebagai after_cursor untuk mendapatkan halaman seterusnya.

Practical notes

• Opaque token: Anggap cursor sebagai rentetan yang tidak disiasat. Jangan cuba mengurai atau membinanya di pihak klien.
• No numeric offset: Gamma API menolak offset berangka; gunakan after_cursor untuk penomboran dengan /markets. Endpoint menyokong limit (maks 1000) bersama after_cursor.
• Ordering matters: Penomboran kursor berkait rapat dengan urutan pertanyaan. Jika anda menukar medan susunan, anda mungkin tidak dapat menyambung semula menggunakan cursor terdahulu.
• Robust clients: Simpan cursor jika anda bercadang menyambung semula imbasan panjang, dan tangani keadaan di mana cursor yang dikeluarkan sebelum ini menjadi lapuk atau tidak menghasilkan keputusan.

See also

• /glossary/gamma-api