Paginazione

Tutti gli endpoint che restituiscono liste di risultati supportano la paginazione lato server. Questo permette di recuperare grandi set di dati in blocchi gestibili.

Parametri di richiesta

Parametro	Tipo	Default	Descrizione
`page`	intero	1	Numero della pagina (1-based)
`page_size`	intero	100	Numero di elementi per pagina

Esempio:

curl https://api.invoicetronic.com/v1/receive?page=2&page_size=20 \
  -u YOUR_API_KEY:

Header di risposta

La risposta include l'header Invoicetronic-Total-Count che indica il numero totale di elementi che corrispondono alla query, indipendentemente dalla paginazione.

Header	Descrizione
`Invoicetronic-Total-Count`	Numero totale di elementi disponibili

Il body della risposta contiene solo gli elementi della pagina corrente.

Esempio

Richiesta:

curl -v https://api.invoicetronic.com/v1/receive?page=1&page_size=20 \
  -u YOUR_API_KEY:

Risposta (header):

HTTP/1.1 200 OK
Content-Type: application/json
Invoicetronic-Total-Count: 150

Risposta (body):

[
  { "id": 1, "..." : "..." },
  { "id": 2, "..." : "..." }
]

In questo esempio, ci sono 150 elementi totali. Con page_size=20, ci sono 8 pagine (l'ultima con 10 elementi).

Calcolo delle pagine

Il numero totale di pagine si calcola così:

pagine_totali = ceil(Invoicetronic-Total-Count / page_size)

Tip

Usa Invoicetronic-Total-Count per mostrare informazioni di navigazione all'utente, come il numero totale di pagine o di risultati. Imposta page_size al minimo necessario per il tuo caso d'uso, così da ridurre i tempi di risposta e il consumo di risorse.