Trifaco API

Paginación

Cómo recorrer listados con limit y next_cursor.

Los listados (GET /v1/documents, /v1/api-keys, /v1/webhook-events, /v1/deliveries/{id}/attempts…) devuelven una página:

{
  "items": [],
  "next_cursor": "…",
  "as_of": "…"
}
ParámetroValor
limitEntre 1 y 100. Por defecto 50.
cursorEl next_cursor de la página anterior, sin modificar.
  • Cuando next_cursor es null, no hay más páginas.
  • El cursor es opaco y está ligado a los filtros, la empresa, el ambiente y el recurso. No lo reutilices con otros filtros, otra empresa u otro recurso.
  • Caduca en 24 horas. CURSOR_EXPIRED obliga a reiniciar el listado desde la primera página.
  • GET /v1/documents recorre una instantánea: las admisiones posteriores a la primera página no aparecen hasta que reinicias el listado.
  • En los demás listados, tolera elementos nuevos entre páginas: usa el id para evitar procesar dos veces el mismo elemento.
curl --silent --header @.local/api.headers "http://127.0.0.1:3000/v1/documents?limit=100"
curl --silent --header @.local/api.headers --get "http://127.0.0.1:3000/v1/documents" \
  --data-urlencode "limit=100" --data-urlencode "cursor=VALOR_DE_next_cursor"

El ejemplo de simulación solo revisa la primera página de rangos de numeración. Si tu empresa tiene más de 50 rangos, recorre todas las páginas.