Limites

Quanto dá para chamar, e o que acontece quando passa.

LimiteValor
Chamadas por token120 por minuto, somando todas as rotas
Ações por conta (gerar keys e resetar HWID)30 por minuto, somando painel e todos os tokens
Keys por chamada de geração50
Movimentos por página do extrato200
Keys por consulta com user_ids[]200
Tokens ativos por conta10

Quando passa do limite

A resposta é 429, com o cabeçalho Retry-After dizendo quantos segundos esperar. A message diz o mesmo tempo:

HTTP/1.1 429 Too Many Requests
Retry-After: 55
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
{
  "success": false,
  "message": "Muitas requisições. Tente de novo em 55 segundo(s).",
  "errors": []
}

As respostas que deram certo trazem X-RateLimit-Limit (o limite) e X-RateLimit-Remaining (quanto ainda resta) do limite mais perto de estourar. Use o Remaining para diminuir o ritmo antes de chegar ao 429.

Como não chegar ao limite

  • Guarde a lista de produtos por alguns minutos em vez de buscar a cada venda.
  • Consulte só as keys que interessam, com user_ids[].
  • Prefira webhooks a perguntar à API de tempos em tempos.
  • Em lote grande, gere até 50 keys por chamada em vez de uma por vez.

Nesta página