Limites de Taxa

A API da Wappfy aplica limites de taxa para garantir uso justo e estabilidade da plataforma.

Limites padrão

Escopo	Limite	Janela
Por usuário	100 requisições	1 minuto
Por IP (não autenticado)	20 requisições	1 minuto

Toda resposta inclui informações de rate limit:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1707580800

Header	Descrição
`X-RateLimit-Limit`	Máximo de requisições permitidas na janela
`X-RateLimit-Remaining`	Requisições restantes na janela atual
`X-RateLimit-Reset`	Timestamp Unix de quando a janela reseta

Quando você excede o limite, receberá uma resposta 429:

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests, please try again later"
  }
}

Implemente backoff exponencial

Quando receber um 429, aguarde e tente novamente com atrasos crescentes: 1s, 2s, 4s, 8s…

Use o header Reset

Verifique X-RateLimit-Reset para saber exatamente quando você pode retomar.

Agrupe operações quando possível

Envie mensagens com atrasos razoáveis entre elas em vez de disparar todas de uma vez.

Cache de respostas

Evite re-buscar dados que não mudaram (ex: detalhes de instância, info de contato).