API pública

Paginar resultados e ficar dentro dos limites

Endpoints de listagem paginam por cursor e não por offset, então siga o cursor que a resposta devolve em vez de calcular um. Fique de olho nos headers de limite e use updatedSince para consultar em vez de reler tudo.

Revisado em 20 de agosto de 2026

Passos

1. Siga o cursor de cada resposta até não vir mais nenhum. Não construa cursores por conta própria.
2. Mantenha um tamanho de página razoável — páginas maiores significam menos requisições, porém mais lentas.
3. Consulte com updatedSince em vez de percorrer a coleção inteira num agendamento.
4. Leia os headers de limite e desacelere antes de ser recusado, não depois.
5. Guarde o requestId de tudo que falhar, para o suporte.

Como conferir o resultado

Uma varredura completa devolve cada objeto uma vez, e uma consulta repetida lê só o que mudou.

O que costuma dar errado

• Montar páginas por offset, que escorregam quando os dados mudam por baixo.
• Reler tudo a cada minuto e bater no limite.
• Reusar um cursor velho e receber erro de cursor inválido.