Operação da integração · v1 em prévia
Distribua as consultas ao longo do tempo.
O contrato inicial limita cada credencial a 600 requisições por janela móvel de 60 segundos.
Ao atingir a cota
A API retorna 429 rate_limited com Retry-After em segundos. Aguarde pelo menos o intervalo informado antes de tentar novamente e distribua as novas consultas para evitar uma nova concentração.
Reduza chamadas desnecessárias
Na rotina
- Use páginas de até 100 registros quando adequado.
- Coordene processos que compartilham a mesma credencial.
- Evite consultas em laços sem intervalo.
Na expectativa
- Não interprete o teto como capacidade ou SLA garantidos.
Planeje uma rotina compartilhada
O limite pertence à credencial. Dois processos com a mesma chave disputam a mesma cota. Distribua as consultas e centralize a coordenação quando houver mais de um trabalhador.
Uma varredura de 2.500 registros com páginas de 100 exige pelo menos 25 chamadas, além de novas tentativas e outras consultas da aplicação. É um exemplo de dimensionamento, não uma autorização para consultar continuamente no teto.
Referência conferida em 23 de setembro de 2026. Relatar uma dúvida na documentação.