Saltar al contenido
Menú
Saltar la navegación de la documentación

Español API 2026-10-22

Documentación · Conceptos · API v1 · versión 2026-10-22

Paginación

Las listas de la API de Trevol usan cursores (starting_after); los SDK ofrecen iteradores que recorren todas las páginas.

Ver como Markdown

Las listas devuelven un sobre {object: "list", data, has_more, next_cursor}. Pide la página siguiente con starting_after=<next_cursor>; limit cambia el tamaño de la página.

GET /v1/invoices

cURL
curl "https://api.trevol.si/v1/invoices?limit=100" \
  -H "Authorization: Bearer $TREVOL_API_KEY"

Probar en el Playground

  • Los listados de documentos filtran por status, external_id, created_from y created_to; los de nómina, por employee_code y period_end_from/period_end_to (nunca por la cédula).
  • Si una página con has_more verdadero no trae next_cursor, usa el id del último elemento.
  • GET /v1/events guarda los eventos 30 días y GET /v1/requests, el registro de peticiones, otros 30.

Iteradores en los SDK

Cada SDK trae un iterador perezoso con su idioma: paginate devuelve un AsyncIterable en Node, un generador en Python y PHP, un Iterable en Java, un IAsyncEnumerable en C#, un iter.Seq2 en Go y un Enumerator::Lazy en Ruby. Pides la primera página, y el iterador sigue solo con next_cursor mientras has_more. En el README de cada SDK hay un ejemplo completo.