Paginación

Paginación por cursor: limit, next_cursor y un orden estable.

GET /v1/properties devuelve una página cada vez:

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

​

Parámetros

Parámetro	Predeterminado	Significado
limit	25	Cuántos elementos por página, de 1 a 100. Cualquier otro valor recibe 400 invalid_limit.
cursor	ninguno	El page.next_cursor de la página anterior. Omítelo en la primera página.

​

Recorrer una lista

1. Solicita la primera página sin cursor.
2. Si page.next_cursor es una cadena, solicita la página siguiente con cursor igual a ese valor, exactamente como lo recibiste (codifícalo para URL).
3. Detente cuando page.next_cursor sea null: esa era la última página.

El orden es estable, así que recorrer todas las páginas devuelve cada elemento exactamente una vez y no se salta ninguno. Una guía muestra un bucle completo.

​

Acerca de los cursores

• Un cursor es opaco: su contenido no significa nada para ti y puede cambiar de formato en cualquier momento.
• Un cursor solo funciona con la credencial PMS y el entorno que lo recibieron. Enviado con otra clave, o editado de cualquier forma, recibe 400 invalid_cursor.
• No guardes cursores para más adelante ni los construyas a mano. Para empezar de nuevo, solicita otra vez la primera página.