Limites de Requisições

Implementamos limites de requisições na API para garantir estabilidade e evitar uso abusivo.

Aplicamos os limites por token da api e os calculamos por minuto.

Limites por Endpoint

Categoria	Limite	Endpoints
Envio de mensagens	20/min	POST /messages
Verificação de número	10/min	POST /contacts/verifynumber
Leitura	60/min	Todos os endpoints GET
Escrita	30/min	Outros endpoints POST, PUT, DELETE

Headers de Resposta

Incluímos em todas as respostas headers para monitoramento do limite:

Header	Descrição
X-RateLimit-Limit	Total de requisições permitidas por minuto
X-RateLimit-Remaining	Requisições restantes no período atual
Retry-After	Segundos para aguardar (apenas no erro 429)

Limite Excedido

Ao exceder o limite, retornamos erro 429 Too Many Requests:

{
  "success": false,
  "message": "Muitas requisições. Tente novamente em alguns segundos.",
  "retry_after": 45
}

Aguarde o tempo indicado em retry_after antes de fazer novas requisições.

Boas Práticas

• Monitore o header X-RateLimit-Remaining para evitar atingir o limite
• Implemente cache local para dados que não mudam com frequência
• Use paginação adequada para reduzir quantidade de requisições
• Em caso de erro 429, aguarde o tempo indicado antes de tentar novamente