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 retornaHTTP 429:
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-Aftere adicione backoff exponencial - Use
limit=100— maximizar olimitreduz 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

