Rate limits
Como a Stater aplica limites de requisição e como tratá-los.
Cada conta tem limites por rota para garantir a estabilidade da
plataforma. Os limites efetivos podem ser consultados em
GET /v1/account/rate-limit.
Multiplicador da conta
O campo multiplier escala o limite padrão por rota:
1.0— limite padrão.0— sem limite (contas dedicadas).0.01..100— qualquer escala intermediária.
Headers retornados
Toda resposta inclui informações sobre o uso atual:
http
X-RateLimit-Limit: 100X-RateLimit-Remaining: 87X-RateLimit-Reset: 1736870000Retry-After: 12Tratando 429
Quando o limite é excedido, a Stater devolve 429 rate_limited
com o header Retry-After em segundos. Implemente backoff
exponencial nos retries.
typescript
async function call(req: () => Promise<Response>) {for (let i = 0; i < 5; i++) { const res = await req(); if (res.status !== 429) return res; const wait = Number(res.headers.get("Retry-After") ?? 2 ** i); await new Promise((r) => setTimeout(r, wait * 1000));}throw new Error("Rate limit excedido após 5 tentativas");}