Vai al contenuto principale
API

Paginazione

Per mantenere l’API veloce e reattiva, le query di elenco limitano la quantità di dati restituita in una singola richiesta. Nell’API vengono usati due tipi di paginazione:

  • Basata su cursore (attuale): usata dalle query di elenco sviluppate di recente.
  • Basata su offset (legacy): usata dalla maggior parte delle query di elenco esistenti. In futuro verranno sostituite da versioni basate su cursore.

Paginazione basata su cursore

La paginazione basata su cursore è lo standard attuale. Ti permette di definire il punto di partenza di una richiesta tramite un cursore, un identificatore univoco di una posizione nell’insieme dei risultati.

Argomenti

first · Integer
Il numero di elementi da restituire.
after · String
Il cursore da cui partire. Ometti questo argomento, o impostalo su null, per ottenere la prima pagina. Per le pagine successive, usa il valore page_info.end_cursor della risposta precedente.

Risposta

La risposta restituisce i risultati direttamente tramite un array nodes, insieme ai metadati di paginazione.

nodes · Array
L’elenco degli oggetti dati della pagina corrente.
total_count · Integer
Il numero totale di elementi che corrispondono alla query, in tutte le pagine.
page_info.has_next_page · Boolean
Indica se sono disponibili altri risultati dopo la pagina corrente.
page_info.has_previous_page · Boolean
Indica se sono disponibili altri risultati prima della pagina corrente.
page_info.start_cursor · String
Il cursore del primo nodo in nodes.
page_info.end_cursor · String
Il cursore dell’ultimo nodo in nodes. Usa questo valore come argomento after nella tua query successiva.

Paginazione basata su offset (legacy)

La paginazione basata su offset è lo standard legacy, ancora usato dalla maggior parte delle query di elenco. Usa page per saltare un numero definito di record e size per restituire una finestra fissa di risultati.

Argomenti

size · Integer
Il numero di elementi da restituire per pagina.
page · Integer
Il numero della pagina da ottenere. Ometti questo argomento, o impostalo su 0, per ottenere la prima pagina.

Risposta

La risposta restituisce direttamente un elenco di oggetti dati, limitato dal valore di size.

Questo contenuto ti è stato utile?

Sviluppatori

Chargetrip ©

Gestisci i cookie

In vigore dal: 20 marzo 2024 · Aggiornato il: 1 settembre 2026

Utilizziamo i cookie per migliorare la tua esperienza su developers.chargetrip.com. Questa informativa sui cookie fa parte dell’informativa sulla privacy e riguarda l’uso dei cookie tra il tuo dispositivo e il nostro sito. Forniamo inoltre informazioni di base sui servizi di terze parti che potremmo utilizzare, i quali possono a loro volta usare cookie come parte del proprio servizio, anche se non sono coperti dalla nostra informativa.

Se non desideri accettare alcun cookie da parte nostra, devi impostare il tuo browser in modo che rifiuti i cookie di developers.chargetrip.com, tenendo presente che potremmo non essere in grado di offrirti alcuni dei contenuti e dei servizi desiderati.

Un cookie è un piccolo dato che un sito web memorizza sul tuo dispositivo quando lo visiti. In genere contiene informazioni sul sito stesso, un identificatore univoco che consente al sito di riconoscere il tuo browser quando torni, dati aggiuntivi legati alla finalità del cookie stesso e la durata del cookie.

I cookie vengono utilizzati per abilitare determinate funzionalità (ad es. l’accesso), per monitorare l’utilizzo del sito (ad es. analisi), per memorizzare le tue impostazioni utente (ad es. fuso orario, preferenze di notifica) e per personalizzare i tuoi contenuti (ad es. pubblicità, lingua).

I cookie impostati dal sito web che stai visitando sono normalmente chiamati “cookie di prima parte” e in genere monitorano solo la tua attività su quel particolare sito. I cookie impostati da altri siti e aziende (ossia terze parti) possono essere utilizzati per monitorarti su altri siti web che usano lo stesso servizio di terze parti.

I cookie impostati dal sito web che stai visitando sono normalmente chiamati “cookie di prima parte” e in genere monitorano solo la tua attività su quel particolare sito. I cookie impostati da altri siti e aziende (ossia terze parti) possono essere utilizzati per monitorarti su altri siti web che usano lo stesso servizio di terze parti.

I cookie di targeting / pubblicitari vengono utilizzati per determinare quali contenuti promozionali sono più rilevanti e appropriati per te e per i tuoi interessi. I siti web possono usarli per mostrare pubblicità mirata o per limitare il numero di volte in cui visualizzi un annuncio. Questo aiuta le aziende a migliorare l’efficacia delle loro campagne e la qualità dei contenuti che ti vengono presentati. Questi cookie possono essere impostati dal sito web che stai visitando (di prima parte) o da servizi di terze parti. I cookie di targeting/pubblicitari impostati da terze parti possono essere utilizzati per monitorarti su altri siti web che usano lo stesso servizio di terze parti. Sul nostro sito utilizziamo cookie di targeting/pubblicitari.

I cookie di targeting / pubblicitari vengono utilizzati per determinare quali contenuti promozionali sono più rilevanti e appropriati per te e per i tuoi interessi. I siti web possono usarli per mostrare pubblicità mirata o per limitare il numero di volte in cui visualizzi un annuncio. Questo aiuta le aziende a migliorare l’efficacia delle loro campagne e la qualità dei contenuti che ti vengono presentati. Questi cookie possono essere impostati dal sito web che stai visitando (di prima parte) o da servizi di terze parti. I cookie di targeting/pubblicitari impostati da terze parti possono essere utilizzati per monitorarti su altri siti web che usano lo stesso servizio di terze parti. Sul nostro sito utilizziamo cookie di targeting/pubblicitari.

Impegno verso le terze parti

Esaminiamo le informative sulla privacy di tutti i nostri fornitori terzi prima di avvalerci dei loro servizi, per assicurarci che le loro pratiche siano in linea con le nostre. Non includeremo mai consapevolmente servizi di terze parti che compromettano o violino la privacy dei nostri utenti.

Cookie
google-cookie-consent
Descrizione
Memorizza le tue preferenze sui cookie, ovvero quali categorie hai accettato o rifiutato, così da rispettare la tua scelta a ogni visita e caricare solo gli strumenti di analisi o di marketing che hai consentito.
Durata
2 anni

Se non desideri accettare cookie da parte nostra, puoi impostare il tuo browser in modo che rifiuti i cookie del nostro sito web. La maggior parte dei browser è configurata per accettare i cookie per impostazione predefinita, ma puoi modificare queste impostazioni per rifiutare del tutto i cookie oppure per ricevere una notifica quando un sito web tenta di impostarne uno.

Se navighi su siti web da più dispositivi, potrebbe essere necessario aggiornare le impostazioni su ciascun dispositivo.

Sebbene alcuni cookie possano essere bloccati con un impatto minimo sull’esperienza di un sito web, bloccare tutti i cookie potrebbe impedirti di accedere a determinate funzionalità e contenuti dei siti che visiti.

Potremmo aggiornare periodicamente questa Informativa sui cookie per riflettere, ad esempio, modifiche ai cookie che utilizziamo o per altri motivi operativi, legali o normativi. Ti invitiamo a consultare nuovamente questa Informativa sui cookie per restare informato sul nostro utilizzo dei cookie e delle tecnologie correlate. La data indicata all’inizio di questa Informativa sui cookie indica quando è stata aggiornata l’ultima volta.