Ir para o conteúdo

Limites de taxa

Para garantir alto desempenho e confiabilidade para todos os usuários, o SMSBAT aplica limitação de taxa às solicitações de API. Os limites de taxa especificam o número máximo de chamadas de API que você pode fazer em um determinado período.

Limites padrão

A menos que especificado de outra forma em seu contrato, os limites de taxa padrão são aplicados em todos os endpoints da API (API SMSBAT, API Cascade e API ChatHub).

Categoria API Limite padrão Limite de explosão
Pontos finais de mensagens (/bat/messagelist) 100 solicitações/segundo 150 solicitações/segundo
Endpoints de dados (status, saldo, informações) 50 solicitações/segundo 75 solicitações/segundo

[!NOTA] Para mensagens de saída (por exemplo, POST /bat/messagelist), uma solicitação HTTP pode conter até 5.000 mensagens no array messages. O limite de taxa se aplica ao número de solicitações HTTP, não ao número de mensagens enviadas.

Lidando com Limites de Taxa

Se você exceder o limite de taxa permitido, a API responderá com um código de status HTTP 429 Too Many Requests.

Exemplo de resposta

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please wait before sending more requests.",
  "status": 429
}

Melhores Práticas

Para evitar a limitação de taxa, considere as seguintes práticas recomendadas:

  1. Agrupe suas mensagens: em vez de enviar 1.000 solicitações HTTP separadas para 1.000 mensagens SMS, envie uma única solicitação contendo uma matriz de 1.000 objetos.
  2. Implementar retirada exponencial: Se você receber um código de status 429, aguarde um curto período (por exemplo, 1 segundo) e tente novamente. Se falhar novamente, dobre o tempo de espera (2s, 4s, 8s, etc.).
  3. Acelere suas solicitações: se você estiver executando um script automatizado que aciona milhares de chamadas de API, introduza um pequeno atraso (por exemplo, sleep(10) milissegundos) entre as solicitações.

Solicitando um aumento de limite

Se o seu caso de uso exigir uma taxa de transferência superior aos limites padrão, você poderá solicitar um aumento.

  1. Entre em contato com seu gerente de conta dedicado ou envie um e-mail para [email protected].
  2. Forneça o ID da sua conta e o rendimento esperado (por exemplo, 500 solicitações por segundo).
  3. Descreva resumidamente seu caso de uso.

Nossa equipe técnica analisará sua solicitação e ajustará seus limites de acordo.