Rate limits

cuidado

⚠️ Atenção: A fim de prevenir problemas decorrentes de ataques por força bruta ou mesmo uma sobrecarga de solicitações provenientes de integrações, implementamos um mecanismo que limita o número de requisições processadas paralelamente.

Se a camada de integração atingir o seu limite de capacidade, as solicitações subsequentes começarão a receber a resposta com status "429 - Too Many Requests". Esta medida visa assegurar a estabilidade e o funcionamento eficaz do sistema.

O que é Limitação de Taxa (Rate Limit)?

A limitação de taxa, ou "Rate Limit", é uma medida adotada para prevenir o excesso de solicitações à API do SoftExpert Suite em um curto espaço de tempo. Caso seu aplicativo realize muitas requisições em um período breve, é possível que receba como resposta o código de status HTTP 429. Este erro indica que o seu aplicativo excedeu nosso limite de taxa da API web.

A implementação desses limites pela API do SoftExpert Suite tem como objetivo principal garantir a confiabilidade do nosso serviço. Ademais, a limitação de taxa ajuda a orientar desenvolvedores de terceiros a utilizarem nossa API de maneira responsável e sustentável.

Rate limit do SoftExpert Suite

O limite de taxa de API para o SoftExpert Suite é determinado com base no número de solicitações que o seu aplicativo envia ao SoftExpert Suite em uma janela de tempo de 1 segundo. Dentro deste intervalo, somente 10 requisições são permitidas. Se o seu aplicativo ultrapassar este limite de taxa, a API web do SoftExpert Suite começará a retornar o código de status HTTP 429 como resposta. Como resultado, você pode receber relatos de usuários sobre comportamentos anômalos que eles experimentaram ao utilizar o seu aplicativo.

Exceções

Esteja ciente de que a SoftExpert às vezes implementa outros limites fora do limite de taxa padrão. Ou seja, algumas APIs ou Web Services podem ter um limites exclusivos, devido a alta demanda de consumo ou o seu uso expressivo.

Implemente uma estratégia de Backoff-Retry

Se o seu aplicativo exceder o limite de requisições, receberá uma resposta com o código de erro 429 do SoftExpert Suite. Esta informação pode ser utilizada pelo seu aplicativo como um indicativo para reduzir o número de solicitações de API que ele está fazendo à API web. Uma abordagem eficaz para gerir esta situação é desenvolver uma estratégia novas tentativa (Backoff-Retry), que permitirá ao seu aplicativo ajustar-se dinamicamente à limitação de taxa imposta.

Estude os padrões de requisição do seu aplicativo

Ao acessar Widgets do API Manager do SoftExpert Suite, você se deparará com um gráficos e informações que ilustra o volume de solicitações de API ao longo do tempo. Compreender as anomalias nessas requisições - bem como suas causas - pode proporcionar insights valiosos para evitar atingir os limites de taxa. Por exemplo, caso observe um pico de tráfego no seu site após o envio do boletim informativo semanal, pode ser interessante escalonar a distribuição desses e-mails durante o decorrer do dia.

Para uma análise mais aprofundada dos padrões de requisições do seu aplicativo, recomendamos o rastreio das chamadas de API do seu aplicativo para o SoftExpert Suite usando suas próprias ferramentas de registro. Dessa forma, você poderá coletar dados mais precisos e personalizados, otimizando ainda mais a eficiência e o desempenho do seu aplicativo.

Considere implementar recursos de "lazy loading"

Os usuários muitas vezes não querem usar todos os recursos que estão disponíveis para eles em uma página da web ou na visualização de um aplicativo móvel. Você pode evitar fazer requisições de API tornando as chamadas de API condicionais às interações do usuário, como tocar em um link 'saiba mais' ou rolar até uma região definida de uma página da web.