<!-- https://www.akrus.digital/docs/limites · revisado em 2026-10-08 · gerado do mesmo conteúdo da página HTML -->
_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.

> **Antes de integrar**
>
> Contrato em prévia. A implementação foi validada localmente; a liberação em produção ainda precisa ser confirmada pela equipe. O acesso programático exige plano Scale efetivo, credencial e escopos autorizados. Solicite acesso e a URL do ambiente antes de integrar.
>
> [Ver disponibilidade](https://www.akrus.digital/docs/ambientes)

## 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.

> **Quando o limitador está indisponível**
>
> A API retorna 503 unavailable se não conseguir verificar ou registrar o limite. Trate a indisponibilidade com espera progressiva e um número limitado de tentativas.

## 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.

---

Anterior: [Erros](https://www.akrus.digital/docs/erros) · Próximo: [Sincronização e reconciliação](https://www.akrus.digital/docs/sincronizacao)
