Vai al contenuto

Paginazione

Gli endpoint che restituiscono liste supportano la paginazione tramite query parameter, così puoi navigare grandi insiemi di dati senza scaricarli tutti in un'unica richiesta.

Parametri

Parametro Descrizione
Skip Numero di elementi da saltare dall'inizio del set di risultati.
Take Numero di elementi da includere nella risposta.

Per esempio, per ottenere la seconda pagina da 50 elementi:

GET /api/v3/1/articolo?Skip=50&Take=50

Header della risposta

Ogni risposta paginata include due header che descrivono il set di risultati:

Header Descrizione
X-Read-TotalCount Numero totale di elementi che soddisfano il filtro corrente.
X-Read-Count Numero di elementi effettivamente restituiti nel body della risposta.

X-Read-TotalCount ti consente di calcolare il numero di pagine e di mostrare un indicatore di avanzamento, mentre X-Read-Count riflette quanti elementi sono presenti nella risposta corrente.

Ottimizzare le prestazioni

Calcolare il conteggio totale ha un costo. Se non ti serve, puoi ometterlo per ottenere prestazioni migliori:

Parametro Descrizione
SkipTotalCount Se true, l'header X-Read-TotalCount viene omesso dalla risposta. Default false.