Skip to main content

Visão geral

A API aplica três camadas de rate limiting para garantir estabilidade do serviço:

Limites por plano

Limites por canal (envio de mensagens)

Independente do plano, o envio de mensagens tem limites adicionais por canal:

Headers de rate limit

Cada resposta bem-sucedida inclui headers informativos:

Quando o limite é atingido

Ao exceder qualquer limite, a API retorna HTTP 429:
O header Retry-After indica quantos segundos aguardar antes de tentar novamente.

Como implementar retry

Boas práticas

  • Distribua requisições no tempo — evite enviar 60 requisições simultâneas no início de cada minuto
  • Implemente retry com backoff — sempre respeite o Retry-After e adicione backoff exponencial
  • Use limit=100 — maximizar o limit reduz o número de requisições para buscar muitos registros
  • Filtre no lado servidor — use os parâmetros de filtro disponíveis em vez de filtrar no cliente
  • Cache dados estáticos — membros, funis de venda e instâncias mudam pouco; cache por alguns minutos