Paginação por cursor
Todos os endpoints de listagem usam paginação por cursor (cursor-based pagination), que é mais eficiente e consistente do que paginação por offset, especialmente em conjuntos de dados que mudam com frequência.Parâmetros de query
Estrutura da resposta
Navegando pelas páginas
1
Primeira página
Faça a requisição sem o parâmetro
cursor:2
Verifique se há mais
Se
meta.has_more for true, use meta.next_cursor na próxima requisição.3
Próximas páginas
Passe o cursor como parâmetro:
4
Última página
Quando
meta.has_more for false, você chegou ao fim da lista.Exemplo: buscar todos os contatos
Notas importantes
- Cursores não são permanentes — não armazene cursores para uso posterior. Eles devem ser usados imediatamente dentro da mesma sessão de paginação.
- Filtros persistem — ao passar um cursor, mantenha os mesmos filtros (
search,tag, etc.) da requisição original. - Ordem não muda — a ordenação padrão é por
created_atdecrescente (mais recentes primeiro). - O total é aproximado —
meta.totalreflete a contagem sem filtros aplicados.

