FreteFlow / docs

API: rate limits

Limites por API key, headers e estratégias.

Limites padrão

  • 60 requisições / minuto por API key (planos básicos).
  • 300 requisições / minuto em planos avançados.
  • Webhooks de saída: até 10/segundo por endpoint.

Headers de resposta

text
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1714680600   # epoch seconds

Backoff exponencial

Quando receber 429, aguarde antes de tentar de novo:

ts
async function withRetry<T>(fn: () => Promise<Response>, max = 4): Promise<T> {
  for (let i = 0; i < max; i++) {
    const res = await fn();
    if (res.status !== 429) return res.json() as Promise<T>;
    const retryAfter = Number(res.headers.get("Retry-After") ?? 1);
    await new Promise((r) => setTimeout(r, retryAfter * 1000 * (i + 1)));
  }
  throw new Error("rate limit exceeded after retries");
}

Aumento de limite

Precisa de mais? Fale com o suporte com sua key e o caso de uso — avaliamos aumento sob medida.