Qué es un rate limit (límite de peticiones) y cómo manejarlo

Si has integrado dos herramientas y de pronto empiezan a fallar los mensajes con un error "429", te topaste con un rate limit. Es uno de los conceptos más importantes (y más ignorados) al trabajar con APIs e integraciones. En esta guía verás qué es un rate limit, por qué existe y, sobre todo, cómo diseñar tus procesos para que nunca te bloqueen.

Qué es un rate limit

Un rate limit, o límite de peticiones, es una restricción que impone un servicio sobre cuántas solicitudes puedes hacerle en un período de tiempo determinado. Por ejemplo:

• 100 peticiones por minuto.
• 1.000 mensajes por hora.
• 10.000 llamadas a la API por día.

Si superas ese umbral, el servicio rechaza tus siguientes peticiones (normalmente con el código HTTP 429 Too Many Requests) hasta que pase la ventana de tiempo o hasta que reduzcas el ritmo.

Por qué existen los rate limits

Lejos de ser un capricho, los límites de peticiones cumplen funciones importantes:

1. Estabilidad: evitan que un solo cliente sature el servidor y afecte a todos los demás.
2. Seguridad: frenan ataques de fuerza bruta y abusos automatizados.
3. Equidad: reparten la capacidad entre todos los usuarios de forma justa.
4. Control de costos: protegen la infraestructura de picos incontrolados.

En el mundo de la mensajería empresarial, además, muchas plataformas (como WhatsApp Cloud API) imponen sus propios límites de envío para proteger a los usuarios del spam. Ignorarlos puede costarte la calidad de tu número o incluso su bloqueo.

Tipos comunes de límites

• Por ventana fija: cuenta peticiones en bloques (por ejemplo, cada minuto se reinicia).
• Por ventana deslizante: mira los últimos 60 segundos en cualquier momento, es más suave.
• Token bucket (cubo de fichas): tienes un "cubo" que se rellena a un ritmo constante; cada petición consume una ficha, y si el cubo está vacío, esperas.
• Límites por recurso: distintos endpoints pueden tener límites diferentes.

Cómo saber cuál es tu límite

La mayoría de las APIs comunican tu estado a través de cabeceras HTTP en cada respuesta, como:

• X-RateLimit-Limit: tu límite total.
• X-RateLimit-Remaining: cuántas peticiones te quedan.
• Retry-After: cuántos segundos esperar antes de reintentar.

Leer estas cabeceras es la clave para adaptar tu ritmo en tiempo real en lugar de chocar contra el muro.

Estrategias para no chocar con el rate limit

1. Reintentos con retroceso exponencial

Si recibes un 429, no reintentes de inmediato. Espera un poco, y si vuelve a fallar, espera el doble, luego el cuádruple, y así. Este patrón ("exponential backoff") evita empeorar la congestión.

2. Encolar y espaciar

En lugar de disparar mil peticiones de golpe, ponlas en una cola y procésalas a un ritmo controlado, por debajo del límite.

3. Cachear resultados

Si pides el mismo dato muchas veces, guárdalo temporalmente en lugar de volver a consultarlo cada vez.

4. Agrupar peticiones (batching)

Algunas APIs permiten enviar varias operaciones en una sola llamada. Úsalo cuando esté disponible.

5. Usar webhooks en vez de sondear

En lugar de preguntar cada segundo "¿hay novedades?", deja que la API te avise cuando ocurra algo. Consumes muchísimas menos peticiones.

Rate limits en una operación de mensajería

Cuando envías campañas o respondes a miles de clientes en varios canales, respetar los límites de cada plataforma es vital para que tus mensajes lleguen. Una plataforma omnicanal como Omnifox gestiona por ti el ritmo de envío hacia cada canal, encola los mensajes y aplica reintentos inteligentes, de modo que no tengas que preocuparte manualmente por cada límite de WhatsApp, Instagram o SMS. Eso protege la reputación de tus números y evita que tus automatizaciones se caigan por saturar una API.

Un ejemplo concreto en la práctica

Imagina que quieres enviar un recordatorio a 5.000 clientes y la API permite 80 mensajes por minuto. Si intentas mandarlos todos de golpe, a partir del mensaje 81 empezarás a recibir errores 429 y muchos no llegarán. La solución correcta es repartir el envío: 80 por minuto significa terminar en poco más de una hora, sin un solo rechazo. Ese "gotear" el volumen no solo evita bloqueos, también protege la reputación de tu remitente ante la plataforma, que interpreta los picos bruscos como comportamiento sospechoso.

Errores frecuentes con los rate limits

• Ignorar el código 429 y seguir martillando la API.
• No leer las cabeceras que te dicen cuánto margen te queda.
• Reintentar sin espera, lo que agrava el bloqueo.
• Sondear en bucle cuando existe un webhook disponible.
• No distribuir la carga en el tiempo durante envíos masivos.

Conclusión

Un rate limit no es tu enemigo: es una regla del juego que protege la estabilidad de los servicios que usas. Entenderlo te permite diseñar integraciones robustas que respetan los límites, reintentan con inteligencia y nunca dejan a tus clientes sin respuesta. Si quieres enviar y automatizar a escala sin pelearte con los límites de cada canal, prueba Omnifox y deja que la plataforma se encargue del ritmo por ti.