MagnusPay
MagnusPay

Rate Limiting

Limite de requisições para garantir a estabilidade da API.

Limite

A API aceita até 200 requisições por minuto por IP de origem.

Endpoints públicos como consulta de transação por ID e WebSocket não contam pro limite.

Bloqueio automático

Ao exceder o limite com uma API Key, a chave é desativada automaticamente por 10 minutos. Após esse período, ela volta a funcionar sem intervenção. Implemente retry com backoff exponencial pra evitar.

Headers de resposta

Cada resposta traz headers padrão pra monitorar seu consumo:

Headershttp
RateLimit-Limit: 200
RateLimit-Remaining: 187
RateLimit-Reset: 42
  • RateLimit-Limit — teto na janela atual
  • RateLimit-Remaining — quantas ainda restam
  • RateLimit-Reset — segundos até resetar

Resposta de limite excedido

Ao exceder, a API responde com status 429:

429 Too Many Requestsjson
{
  "success": false,
  "message": "Limite de requisições excedido. Aguarde um momento."
}