Skip to main content

Paginação

limit máximo é 20, não 100. Valores acima são rejeitados pela validação. Para conjuntos maiores, itere sobre page usando o total devolvido em pagination.

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.