Skip to main content

​
Rate limits

A API do TroiaChat aplica limites de requisicoes para garantir estabilidade e disponibilidade para todos os clientes.

​
Limites atuais

RecursoLimiteJanela
Criar lead60 requisicoespor minuto
Os limites acima sao por API Key. Chaves diferentes possuem limites independentes.

​
Headers de resposta

Cada resposta inclui headers indicando o estado atual do rate limit:
HeaderDescricao
X-RateLimit-LimitLimite total de requisicoes na janela.
X-RateLimit-RemainingRequisicoes restantes na janela atual.
X-RateLimit-ResetTimestamp (Unix) de quando a janela reseta.

​
Quando o limite e excedido

Ao exceder o limite, a API retorna status 429 Too Many Requests: 
{
  "success": false,
  "error": "Too many requests, please try again later."
}

​
Boas praticas

1

Implemente backoff exponencial

Ao receber 429, espere antes de reenviar. Comece com 1 segundo e dobre a cada tentativa.
2

Use filas para envios em lote

Se voce precisa enviar muitos leads de uma vez (ex: importacao de planilha), envie com intervalos entre as requisicoes em vez de tudo simultaneamente.
3

Monitore os headers

Verifique X-RateLimit-Remaining para saber quantas requisicoes ainda tem antes de atingir o limite.