Rate limits - Finzaria

Cada respuesta incluye headers que te dicen cuántas peticiones te quedan:

Header	Significado
`X-RateLimit-Limit`	Máximo de peticiones en la ventana actual.
`X-RateLimit-Remaining`	Cuántas te quedan.
`X-RateLimit-Reset`	Segundos hasta que la ventana se reinicia.

Ejemplo:

HTTP/1.1 200 OK
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 94
X-RateLimit-Reset: 60

Cuando te pasas: `429`

Si excedes el límite, recibes 429 Too Many Requests con problem+json. Espera a que la ventana se reinicie (X-RateLimit-Reset) y reintenta con backoff exponencial.

async function callWithRetry(url, opts, tries = 4) {
  for (let i = 0; i < tries; i++) {
    const res = await fetch(url, opts)
    if (res.status !== 429) return res
    const reset = Number(res.headers.get("X-RateLimit-Reset") ?? 1)
    await new Promise((r) => setTimeout(r, (reset * 1000 || 2 ** i * 1000)))
  }
  throw new Error("Rate limit: agotados los reintentos")
}

Revisa X-RateLimit-Remaining de forma proactiva y espacia tus llamadas antes de topar el límite, en vez de esperar al 429.

Idempotencia Versionado

⌘I

​Cuando te pasas: 429

Cuando te pasas: `429`