Documentação da API

Limites de uso

Limites de taxa, tamanho e tempo da API pública e boas práticas de retentativa.

Limite Valor padrão Observação
Requisições por operador 600 por minuto ajustável por operador; janela de 1 minuto
Tamanho do corpo 256 KB acima disso, 413 PAYLOAD_TOO_LARGE
Janela do X-Timestamp ±5 minutos fora dela, 401 TIMESTAMP_OUT_OF_RANGE
Retenção da Idempotency-Key 24 horas por operador
Página do extrato até 200 itens padrão 50
Sessão de jogo (gameUrl) 30 minutos o token da URL expira
Webhooks 8 tentativas espera exponencial de 30 s a 6 h; resposta em até 10 s

Ao exceder o limite de requisições

A resposta é 429 RATE_LIMITED com o cabeçalho Retry-After (segundos).

  • Use backoff exponencial com jitter e respeite Retry-After.
  • Prefira webhooks a consultas repetidas (polling) para acompanhar KYC e saques.
  • Se a sua operação prevê picos (campanhas, eventos), avise a equipe com antecedência para ajustar o limite.