glossaryplatform

¿Qué es un límite de tasa de API? — Herramienta gratuita

Un límite de tasa de API es el tope que una plataforma pone a cuántas peticiones puede hacer una aplicación en una ventana de tiempo. Qué ocurre cuando una herramienta lo alcanza, por qué es un retraso y no un fallo, y qué significa para la programación y las analíticas.

El tope que impone una plataforma al número de peticiones a su API que puede hacer una aplicación en un periodo. Alcanzarlo hace que las herramientas de publicación o analítica fallen temporalmente hasta que el periodo se reinicia.

Qué es

Un límite de tasa es el techo que una plataforma pone a cuántas peticiones de API puede hacer una aplicación dentro de una ventana fija: tantas llamadas cada quince minutos, cada hora o cada día. Existe para que una sola aplicación no consuma una capacidad que es de todos, y se aplica a la aplicación, no a ti.

Cómo se mide

La ventana es lo que importa y lo que la gente se salta. Un límite de mil llamadas por hora no significa mil llamadas repartidas: significa que la aplicación puede gastar toda la asignación en un minuto y esperar cincuenta y nueve. Cuando se agota, la plataforma responde con un 429, a menudo con una cabecera que indica cuándo se reinicia la ventana. Las herramientas que se portan bien leen esa cabecera y esperan. Las que no reintentan de inmediato, vuelven a ser rechazadas y convierten un retraso en un fallo comunicado.

Malentendido habitual

Parece que algo va mal en tu cuenta, y no es así. Nada en un límite de tasa es un juicio sobre tu perfil, tu contenido o tu situación, que es justamente por qué un retraso de publicación causado por uno se resuelve solo sin que cambies nada. La confusión relacionada es con una suspensión: desde fuera, una aplicación limitada y otra a la que le han revocado el acceso se ven igual, como "ha dejado de funcionar". La diferencia es que un límite de tasa dice cuándo termina.

Cuándo importa

Importa cuando pasan muchas cosas a la vez: un lote grande programado para el mismo minuto, un mes de analíticas rellenándose hacia atrás o varias cuentas actualizándose juntas. Por eso las herramientas de publicación reparten el trabajo en vez de lanzarlo todo en punto, y por eso una métrica que falta esta mañana suele estar esta tarde.

Características

  • Definición clara, con la ventana como la parte que importa
  • Qué es una respuesta 429 y por qué no es un error de tu cuenta
  • Por qué los huecos en analíticas y la publicación retrasada suelen compartir esta causa
  • Cómo las herramientas bien hechas esperan en vez de reintentar al instante
  • La diferencia entre un límite de tasa y una suspensión, que desde fuera se parecen

Preguntas frecuentes

¿Qué pasa cuando se alcanza un límite de tasa?

La plataforma rechaza más peticiones hasta que se reinicia la ventana, normalmente con una respuesta 429. Una herramienta bien construida espera y reintenta; una mal construida informa de un fallo que nunca fue tuyo.

¿Alcanzar un límite perjudica a mi cuenta?

No. Es un tope sobre una aplicación, no una penalización sobre ti. Insistir contra el límite en vez de esperar puede acabar restringiendo a la propia aplicación, pero eso afecta a su situación y no a tu perfil.

¿Por qué faltan las analíticas de un día?

Un límite de tasa es una de las causas habituales. Las métricas se recogen preguntando a la plataforma por cada publicación, así que una ventana agotada deja un hueco que se rellena en la siguiente pasada en vez de no llegar nunca.

¿Es lo mismo que un shadowban?

No, aunque se confunden porque ambos parecen algo que en silencio no funciona. Un límite de tasa es un tope documentado con hora de reinicio y un código de respuesta explícito. Una caída de distribución no tiene ninguna de las dos cosas.

¿Puedo subir el límite?

No como usuario de una herramienta. Los límites los fija la plataforma por aplicación y dependen del nivel de acceso que se le concedió, así que la respuesta está siempre del lado de la herramienta y no en tus ajustes.