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
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.