Limites e cotas
Quantas requisições a integração pode fazer, os cabeçalhos que mostram o consumo e como dimensionar a sincronização.
Em resumo
- 60 requisições por minuto, por chave — igual para todas as empresas.
- Uma cota diária por organização, definida pelo plano; ela renova à meia-noite (horário de Brasília).
- Toda resposta mostra o que resta, nos cabeçalhos
RateLimit-*eX-Cota-Diaria-*. - Sincronizar a cada 5 a 15 minutos cabe com folga na cota de qualquer plano.
A cota de cada plano
| Plano | Integrações ativas | Requisições por dia |
|---|---|---|
| Starter | 1 | 2.000 |
| Growth | 1 | 5.000 |
| Pro | 2 | 10.000 |
| Limites maiores | Sob consulta | Sob consulta |
A cota é da organização inteira, e o limite de integrações conta só as ativas. Se o plano mudar para um com menos integrações do que as ativas, funcionam as mais antigas; as demais aparecem como Fora do plano até que alguém desative alguma.
Os cabeçalhos
| Cabeçalho | O que diz |
|---|---|
RateLimit-Limit | Requisições por minuto permitidas para a chave (60) |
RateLimit-Remaining | Quantas restam no minuto |
RateLimit-Reset | Segundos até o minuto renovar |
X-Cota-Diaria-Limite | A cota diária da organização |
X-Cota-Diaria-Restante | Quanto resta hoje |
X-Cota-Diaria-Renova-Em | Quando a cota renova (meia-noite de Brasília) |
Retry-After | Em 429, quantos segundos esperar |
A cota é da organização: várias integrações da mesma empresa somam no mesmo total. O consumo de cada integração aparece na tela dela, no Afflux.
Dimensionando a sincronização
Uma sincronização que consulta 5 recursos a cada 5 minutos faz cerca de 1.440 requisições por dia quando nada muda — cada recurso responde uma página vazia. As mudanças do dia acrescentam poucas páginas, porque cada página traz até 100 registros.
| Intervalo | 5 recursos, sem mudanças | Com a carga inicial |
|---|---|---|
| 15 minutos | ~480 por dia | + dezenas de páginas, uma vez |
| 5 minutos | ~1.440 por dia | + dezenas de páginas, uma vez |
Boas práticas
- Não consulte em laço curto. Para saber de uma conta específica, use o detalhe por id.
- Respeite o
Retry-Aftere não tente de novo em seguida. - Use
limite=100na carga inicial: menos páginas, menos requisições. - Uma integração por sistema: cada uma tem seu limite por minuto e seu consumo visível na tela.