Límites de solicitudes

Los límites se aplican por clave API y por minuto, y dependen de tu plan.

Encabezados

Cada respuesta incluye tu ventana actual:

• x-ratelimit-limit solicitudes permitidas por minuto
• x-ratelimit-remaining solicitudes restantes en esta ventana
• x-ratelimit-reset segundos hasta que se reinicie la ventana

Cuando lo superas

Recibes 429 rate_limited con un encabezado retry-after. Las solicitudes limitadas no se cobran. Espera el número de segundos indicado, idealmente con algo de aleatoriedad:

async function call(url, key, tries = 4) {
  for (let i = 0; i < tries; i++) {
    const res = await fetch(url, { headers: { "x-api-key": key } });
    if (res.status !== 429) return res;
    const wait = Number(res.headers.get("retry-after") ?? 1) * 1000;
    await new Promise((r) => setTimeout(r, wait + Math.random() * 250));
  }
  throw new Error("Rate limited");
}

¿Necesitas límites más altos? Habla con nosotros.