Paginação
Volume de requisições
Os limites de volume dependem do plano contratado. Se o seu caso de uso envolve ingestão em massa ou sincronização periódica de grandes janelas, fale com a equipe da Nomos antes de construir — existe caminho melhor que paginar milhares de páginas.A API não retorna headers
X-RateLimit-*. Não construa sua lógica de retry em torno deles: use o
código de status 429 e backoff exponencial, como descrito em Tratamento de erros.Boas práticas
1
Filtre por data em vez de paginar tudo
Para sincronização incremental, guarde a data da última execução e busque só a janela nova. É
mais rápido e muito mais barato que percorrer o histórico inteiro.
2
Use `limit=20` quando for percorrer
O padrão é 10. Ao paginar conjuntos grandes, 20 corta o número de requisições pela metade.
3
Faça cache do que não muda
Documentos já publicados — atos do DOU, discursos, publicações de diários — não são reescritos.
Proposições mudam; use
sort=recently_updated para pegar só o que se moveu.4
Distribua a carga
Prefira um fluxo constante a rajadas. Rajadas são o que dispara
429.5
Implemente backoff exponencial
Com jitter, para evitar que várias instâncias retentem em sincronia.