Los listados no devuelven la colección completa. La API usa dos estilos de paginación, y cada operación declara el suyo en su página de referencia junto con sus valores por omisión y sus topes.

Ambos devuelven su estado en meta.pagination. El detalle cambia entre los dos estilos, pero el lugar no.

Página

page empieza en 1 y per_page fija su tamaño. per_page tiene tope: se recorta al máximo de la operación —habitualmente 100— en lugar de rechazarse, de modo que un valor mayor no produce error sino la página máxima.

"meta": {
  "pagination": { "page": 2, "per_page": 50, "total": 137, "total_pages": 3 }
}

total es el número de elementos que cumplen los filtros aplicados, y total_pages cuántas páginas ocupan. El recorrido consiste en pedir page de 1 a total_pages.

Cursor

El changelog crece por un extremo: entre dos peticiones pueden aparecer entradas nuevas, y contar desde el inicio haría que un elemento se repitiera o se saltara. El cursor evita ambas cosas apuntando al punto exacto donde se quedó la respuesta anterior.

limit fija el tamaño y cursor indica dónde continuar. La respuesta trae ambos datos de continuación:

"meta": {
  "pagination": {
    "total": 412,
    "limit": 25,
    "has_more": true,
    "next_cursor": "eyJyZWxlYXNlX3ZlcnNpb24iOiIxLjQ3LjEiLCJlbnRyeV9pbmRleCI6MX0="
  }
}

El recorrido consiste en repetir la petición enviando en cursor el next_cursor recibido, mientras has_more sea true. La primera petición se hace sin cursor.

El changelog admite además page_by, que no cambia el estilo sino qué cuenta limit: entry (por omisión) cuenta entradas sueltas y minor cuenta grupos de versión menor.

Un parámetro que no corresponde se ignora en silencio

Cada operación acepta únicamente los parámetros de su estilo. Los demás no producen error: se descartan.

Conviene tenerlo presente porque el fallo no se anuncia. Enviar offset a un listado que pagina por página no devuelve un 400; devuelve la página 1, y la devuelve otra vez en cada petición. Un recorrido escrito con offset contra ese listado nunca termina —siempre llega una página llena— y repite los mismos elementos indefinidamente.

Ante un recorrido que no avanza, lo primero que hay que mirar es si los parámetros enviados son los del estilo de esa operación. Su página de referencia los indica.