Pular para o conteúdo principal

Limitação de Frequência

Headers da requisição HTTP​

Os limites de frequência são retornados por meio dos headers da requisição HTTP.

X-Ratelimit-Bucket: general  
X-Ratelimit-Limit: 60  
X-Ratelimit-Remaining: 21  
X-Ratelimit-Reset: 1533715145

Atualmente, todos os endpoints da API estão sujeitos à limitação de frequência. Permitimos 60 chamadas a cada 60 segundos por padrão. As frequências são limitadas dentro do escopo do número e do tipo de mensagem.

As opções de buckets são:

  • general
  • text
  • media

Se você exceder sua permissão de limite de frequência, a API HTTP começará a retornar um erro de status HTTP 429.

Se você acredita que os limites atuais precisam ser alterados para o seu caso de uso, entre em contato conosco.

A resposta HTTP da API possui os seguintes headers definidos, que ajudam a monitorar seu uso e a permissão restante.

X-Ratelimit-Bucket

Como sua chamada de API foi categorizada. A permissão se aplica por categorias.
O bucket padrão é general. Chamadas de API para enviar mensagens de texto são categorizadas como text e chamadas de API para enviar mensagens com qualquer tipo de anexo de mídia são categorizadas como media.

X-Ratelimit-Limit

Quantas chamadas você tem permissão para fazer para este endpoint da API por número. Atualmente, o valor padrão é 60.

X-Ratelimit-Remaining

Quantas chamadas restam dentro do tempo especificado. Atualmente, os limites de frequência são redefinidos a cada 60 segundos.

X-Ratelimit-Reset

O timestamp Unix em segundos Epoch quando o limite de frequência será redefinido.

Esses limites de frequência são aplicados por número, não por conta.

Controle de Velocidade (Throttling)​

Temos a capacidade de forçar os clientes da API a diminuir a velocidade caso não respeitem as permissões de limite de frequência configuradas.

Se você vir um header de resposta HTTP com X-throttling: 1, significa que você está sendo restringido. A Turn.io manterá a conexão HTTP aberta até que você esteja novamente dentro da permissão de limite de frequência configurada para o seu número.