Limites de requisições

Visão Geral

Para proteger o sistema da academia contra problemas de desempenho durante o uso normal do EVO, as APIs seguem um sistema de rate limits (limitação de requisições). Essas restrições garantem que o ambiente permaneça estável, mesmo sob alta carga de uso.

Os critérios de rate limits estão descritos abaixo:

Critérios de Limite de Requisições

1. Limite por Segundo (por IP)

Limite: 5 requisições por segundo para o mesmo IP.

Comportamento após o limite ser atingido:

Retorno com status code 429 (Too Many Requests).

Aguardar 1 segundo antes de realizar novas requisições.

2. Limite por Minuto (por IP)

Limite: 40 requisições por minuto para o mesmo IP.

Comportamento após o limite ser atingido:

Retorno com status code 429 (Too Many Requests).

Aguardar 1 minuto antes de realizar novas requisições.

💎 Clientes da API PRO não possuem o limite por minuto.

3. Limite por Hora (por Chave de API)

Limite: 10.000 requisições por hora para a mesma chave de API.

Comportamento após o limite ser atingido:

A chave de API ficará bloqueada por 1 hora.

Retorno com status code 429 (Too Many Requests).

Detalhes:

O bloqueio é aplicado à chave específica, independente do IP que realizou as requisições.

Todas as requisições feitas com essa chave contam para o limite.

4. Rate Limit por Hora (por DNS da Academia)

Limite: 20.000 requisições por hora para o mesmo DNS da academia.

Comportamento após o limite ser atingido:

Todas as chaves vinculadas ao DNS da academia ficarão bloqueadas por 1 hora.

Retorno com status code 429 (Too Many Requests).

Detalhes:

O bloqueio é aplicado à academia (validado pelo DNS), independente do IP ou chave de API utilizada.

Todas as requisições feitas pela academia contam para o limite.

Janela de Isenção de Limites

Horário: Das 0h até 5h.

Durante este período, não há aplicação de limites quanto a quantidade de requisições por hora, por DNS ou IP. No entanto, o limite de requisições por segundo e por minuto permanece ativo. Ou seja, é possível realizar requisições em maior volume sem que esses limites sejam aplicados, mas ainda estarão em vigor a restrição de quantidade de requisições por segundo e por minuto.

Requisições em lote podem ser realizadas durante este período.

Operações que demandem alto volume de requisições podem aproveitar essa janela.

Resumo dos Limites

Tipo de Limite	Limite	Bloqueio	Status Code
Por Segundo (por IP)	5 requisições	por 1s	429
Por Minuto (por IP)	40 requisições	por 1m	429
Por Hora (por Chave)	10.000 requisições	por 1h	429
Por Hora (por DNS)	20.000 requisições	por 1h	429

Boas Práticas para Evitar Rate Limits

Implemente um sistema de retry (tentativa) com backoff: Ao receber um status code 429, aguarde antes de tentar novamente.

Evite requisições desnecessárias: Certifique-se de que apenas as requisições essenciais sejam feitas.

Aproveite a janela de isenção: Programe requisições em lote entre 0h e 5h, quando os limites de requisição por hora, DNS e IP não são aplicados, mas atente-se aos limites por requisições por segundo.

Monitore suas requisições: Utilize logs para acompanhar e ajustar seu volume de chamadas à API.

Limites de requisições

Visão Geral#

Critérios de Limite de Requisições#

1. Limite por Segundo (por IP)#

2. Limite por Minuto (por IP)#

3. Limite por Hora (por Chave de API)#

4. Rate Limit por Hora (por DNS da Academia)#

Janela de Isenção de Limites#

Resumo dos Limites#

Boas Práticas para Evitar Rate Limits#

Visão Geral

Critérios de Limite de Requisições

1. Limite por Segundo (por IP)

2. Limite por Minuto (por IP)

3. Limite por Hora (por Chave de API)

4. Rate Limit por Hora (por DNS da Academia)

Janela de Isenção de Limites

Resumo dos Limites

Boas Práticas para Evitar Rate Limits