Paginazione

Paginazione a cursore: limit, next_cursor e un ordine stabile.

GET /v1/properties restituisce una pagina alla volta:

{
  "data": [ /* up to `limit` properties */ ],
  "page": { "next_cursor": "pKZAA9cXZioUAmmXQVzN4RBwg8cC3KXflLg_..." }
}

​

Parametri

Parametro	Predefinito	Significato
limit	25	Quanti elementi per pagina, da 1 a 100. Qualsiasi altro valore riceve 400 invalid_limit.
cursor	nessuno	Il page.next_cursor della pagina precedente. Omettilo per la prima pagina.

​

Scorrere un elenco

1. Richiedi la prima pagina senza un cursor.
2. Se page.next_cursor è una stringa, richiedi la pagina successiva con cursor impostato su quel valore, esattamente come l’hai ricevuto (con la codifica URL).
3. Fermati quando page.next_cursor è null: quella era l’ultima pagina.

L’ordine è stabile: scorrere tutte le pagine restituisce ogni elemento esattamente una volta, senza saltarne nessuno. Una guida mostra un ciclo completo.

​

Sui cursori

• Un cursore è opaco: il suo contenuto non significa nulla per te e il formato può cambiare in qualsiasi momento.
• Un cursore funziona solo con la credenziale PMS e l’ambiente che l’hanno ricevuto. Inviato con un’altra chiave, o modificato in qualsiasi modo, riceve 400 invalid_cursor.
• Non conservare i cursori per dopo e non costruirli a mano. Per ricominciare, richiedi di nuovo la prima pagina.