Paginação

Paginação por cursor: limit, next_cursor e ordem estável.

GET /v1/properties devolve uma página de cada vez:

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

​

Parâmetros

Parâmetro	Predefinido	Significado
limit	25	Quantos itens por página, de 1 a 100. Qualquer outro valor recebe 400 invalid_limit.
cursor	nenhum	O page.next_cursor da página anterior. Omita na primeira página.

​

Percorrer uma lista

1. Peça a primeira página sem cursor.
2. Se page.next_cursor for uma cadeia, peça a página seguinte com cursor igual ao valor recebido (codifique na URL).
3. Pare quando page.next_cursor for null: era a última página.

A ordem é estável, por isso percorrer todas as páginas devolve cada item exatamente uma vez sem saltar nenhum. Um guia mostra um ciclo completo.

​

Sobre os cursores

• Um cursor é opaco: o conteúdo não tem significado para si e o formato pode mudar a qualquer momento.
• Um cursor só funciona com a credencial PMS e o ambiente que o receberam. Enviado com outra chave, ou editado de qualquer forma, recebe 400 invalid_cursor.
• Não guarde cursores para mais tarde nem os construa à mão. Para recomeçar, peça outra vez a primeira página.