Pular para o conteúdo

Erros e rate limiting

  • Rate limit global: 120 requisições / 60s por padrão, com bucket por IP + método + rota (não por API Key nem por empresa). Excedeu → 429 Too Many Requests com retryAfterSeconds.
  • IP do cliente lido de x-forwarded-for (primeiro item) ou request.ip. Store em memória (não distribuído).
  • Não há IP allowlist para rotas autenticadas por API Key (allowlists existem só para webhooks inbound de PSPs).

Formato geral de erro: respostas de erro trazem statusCode, message e error. Body ou parâmetros inválidos retornam 400 com os detalhes dos campos.