Saltar al contenido principal
Conceptos

Paginación

Cómo recorrer listas grandes con cursor o con página y límite.

Cursor

Las listas devuelven los ítems y un nextCursor. Pasa el valor en after para traer la página siguiente; cuando nextCursor vuelva nulo, terminaste. El cursor es estable aunque lleguen ítems nuevos.

GET /emails
curl "https://api.coffeemail.com.br/v1/product/emails?limit=100" -H "Authorization: Bearer $COFFEEMAIL_API_KEY" # { "emails": [ … ], "nextCursor": "eyJpZCI6Ijg…" } curl "https://api.coffeemail.com.br/v1/product/emails?limit=100&after=eyJpZCI6Ijg…" -H "Authorization: Bearer $COFFEEMAIL_API_KEY"

Página y límite

Algunas listas aceptan page y limit y devuelven pagination con total, page, limit y totalPages. En listas muy grandes, total puede ser una estimación (totalIsEstimate).

  • limit llega hasta 100 por página.
  • Prefiere el cursor para recorrer todo y page para pantallas numeradas.