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ámetro | Valor |
|---|---|
limit | Entre 1 y 100. Por defecto 50. |
cursor | El next_cursor de la página anterior, sin modificar. |
- Cuando
next_cursoresnull, 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_EXPIREDobliga a reiniciar el listado desde la primera página. GET /v1/documentsrecorre 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
idpara 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.