Pular para o conteúdo principal
Conceitos

Paginação

Como percorrer listas grandes com cursor ou com página e limite.

Cursor

As listas devolvem os itens e um nextCursor. Passe o valor em after para buscar a próxima página; quando nextCursor vier nulo, acabou. O cursor é estável mesmo com novos itens chegando.

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 e limite

Algumas listas aceitam page e limit e devolvem pagination com total, page, limit e totalPages. Em listas muito grandes, total pode ser uma estimativa (totalIsEstimate).

  • limit vai até 100 por página.
  • Prefira cursor para varrer tudo e page para telas com numeração.