Definizione
Paginazione con cursore
Una strategia di paginazione che usa token opachi invece di offset numerici.
Paginazione con cursore
La paginazione con cursore è una strategia di paginazione che usa un token opaco (un "cursor") per segnare una posizione in un insieme di risultati invece di fare affidamento su offset numerici come page=2 o offset=100. I client inviano il cursore al server (per esempio tramite un parametro after_cursor) per richiedere la pagina successiva. Il server restituisce un nuovo cursore per la pagina seguente nella sua risposta.
In contesto
L'endpoint Gamma /markets di Polymarket richiede la paginazione basata su cursore: le chiamate devono usare il valore after_cursor restituito da una richiesta precedente invece di un parametro offset. Questo approccio di tipo keyset migliora le prestazioni e la coerenza su insiemi di risultati grandi o frequentemente aggiornati, perché il server può riprendere da una posizione stabile senza scandire dall'inizio per ogni pagina. Gamma restituisce un next_cursor in ogni risposta paginata; fornisci quel valore come after_cursor per ottenere la pagina successiva.
Note pratiche
- Token opaco: Tratta il cursore come una stringa non ispezionata. Non tentare di analizzarlo o costruirlo lato client.
- Nessun offset numerico: La Gamma API rifiuta offset numerici; usa after_cursor per la paginazione con /markets. L'endpoint supporta limit (max 1000) insieme a after_cursor.
- L'ordinamento conta: La paginazione con cursore è legata all'ordinamento della query. Se cambi i campi di ordine potresti non riuscire a riprendere usando un cursore precedente.
- Client robusti: Salva i cursori se intendi riprendere una scansione lunga e gestisci il caso in cui un cursore precedentemente emesso diventi obsoleto o non produca risultati.
Vedi anche
- /glossary/gamma-api