Limites e quota

Os limites protegem a sua integração e a experiência de todas as empresas no Loy. Os valores da sua chave aparecem em GET /me e nos cabeçalhos de cada resposta — use sempre esses valores, não números fixos no código.

Limite de velocidade

• Rajada curta (janela de 10 segundos) e limite por minuto, por chave e por empresa.
• Um número pequeno de requisições simultâneas por empresa.
• Ao passar do limite: 429 com rate_limited ou concurrency_limited e o cabeçalho Retry-After (segundos).

Exemplo de cabeçalhos (os números da sua chave podem ser outros):

RateLimit-Policy: "key_minute";q=60;w=60
RateLimit: "key_minute";r=57;t=41
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1791547260

Quota mensal

• Contada por mês do calendário, no fuso de São Paulo.
• Loy-Quota-Limit é a quota contratada; Loy-Quota-Used, o uso do mês; Loy-Quota-Reset, quando zera.
• No piloto o bloqueio só acontece bem acima da quota (429 quota_exceeded); antes disso, a equipe do Loy fala com você.

O que conta na quota

Boas práticas

• Respeite o Retry-After e use espera exponencial em novas tentativas.
• Não faça laços de consulta (polling) curtos; consulte quando o seu sistema precisar do dado.
• Guarde o request_id de respostas com erro.