Algoritmo Token Bucket: límite de tasa API del lado servidor en 40 líneas

Aprende a implementar el algoritmo Token Bucket para limitar la tasa de solicitudes en tu API. Código en ~40 líneas, listo para producción. Protege tu servidor.

1 jul 2026 • 3 min de lectura • Equip Q2BSTUDIO

Control de tráfico justo para tu API con Token Bucket

La gestión del tráfico en APIs es un desafío técnico que va más allá de simplemente manejar reintentos desde el cliente. Para un servidor, implementar un control de tasa eficaz protege la base de datos, garantiza equidad entre inquilinos y previene abusos sin derretir la infraestructura. El algoritmo Token Bucket destaca por su equilibrio entre permitir ráfagas y mantener un ritmo sostenido, ideal para entornos productivos donde cada milisegundo cuenta.

En esencia, el Token Bucket funciona como un depósito que se llena a una velocidad constante y se vacía con cada solicitud. Su gran ventaja es que un cliente que ha estado inactivo puede consumir de golpe todos los tokens acumulados, evitando castigos injustos. La implementación más limpia evita temporizadores internos y calcula el relleno de forma diferida usando el tiempo transcurrido, logrando precisión sin sobrecarga. Cada llamada devuelve no solo aceptación o rechazo, sino también el tiempo estimado de espera (Retry-After), información crucial para que los clientes se comporten de forma educada.

Llevar esto a producción exige superar los límites de una única instancia. Cuando escalas horizontalmente con un balanceador de carga, cada nodo tiene su propio cubo, duplicando efectivamente el límite para un mismo usuario. La solución está en externalizar el estado a Redis mediante scripts Lua atómicos, que leen y decrementan tokens sin condiciones de carrera. Además, conviene establecer TTLs para clientes inactivos, diferenciar límites por clave de API, IP o endpoint, y asignar costes variables a rutas pesadas para que una consulta costosa cuente como varias ligeras.

En Q2BSTUDIO desarrollamos aplicaciones a medida y software a medida que integran estos patrones de rate limiting con robustez. Nuestros equipos combinan inteligencia artificial y agentes IA para optimizar la asignación de recursos, mientras que las soluciones de ciberseguridad garantizan que los límites no sean vulnerables a ataques de denegación. La arquitectura se apoya en servicios cloud AWS y Azure para escalar sin fricción, y para monitorizar el uso en tiempo real ofrecemos servicios inteligencia de negocio con power bi que transforman las métricas de 429 en cuadros de mando accionables. La ia para empresas que implementamos permite incluso ajustar dinámicamente las tasas según el comportamiento del tráfico.

Probar estos límites antes de exponerlos a usuarios reales es igual de crítico. En lugar de depender de pruebas manuales, conviene lanzar ráfagas controladas y verificar que los encabezados X-RateLimit-Remaining y Retry-After se comportan exactamente como se espera. Herramientas como APIKumo facilitan este ciclo, pero la verdadera garantía está en un diseño que contemple cada frontera: el token 21 en una ráfaga de 20, la recarga exacta tras el tiempo calculado, la consistencia en un clúster multinodo.

En definitiva, el Token Bucket no es solo un fragmento de código elegante; es la base de una API profesional que protege su propio ecosistema. Combinarlo con una estrategia de desarrollo y despliegue madura —como la que ofrecemos en nuestros proyectos— asegura que el servicio responda con firmeza a clientes bien intencionados y con cortesía a los abusivos. Si necesitas implementar o mejorar el rate limiting de tu plataforma, nuestro equipo está listo para diseñar una solución a medida que se adapte a tu escala y negocio.

UNA PAUSA?

Juga una estona abans de marxar

ELS NOSTRES SERVEIS

Com et podem ajudar

Intel·ligència artificial

Agents d'IA, chatbots i assistents intel·ligents que automatitzen tasques i atenen els teus clients 24/7 per millorar l'eficiència del teu negoci.

Més info

Desenvolupament de programari

Aplicacions web, mòbils i d'escriptori, intranets, e-commerce, SaaS i plataformes de gestió dissenyades per a les necessitats concretes de la teva empresa.

Més info

Serveis cloud

Migració, infraestructura, hosting gestionat, alta disponibilitat i seguretat en Microsoft Azure i Amazon Web Services perquè el teu negoci escali sense límits.

Més info

Ciberseguretat i pentesting

Auditories de seguretat, test d'intrusió (pentesting) i protecció d'aplicacions, dades i infraestructura on-premise i cloud, amb hacking ètic i compliment normatiu.

Més info

Business Intelligence

Quadres de comandament i anàlisi de dades amb Power BI: integrem les teves fonts, dissenyem dashboards i KPIs i convertim les teves dades en decisions.

Més info

Automatització de processos

Automatitzem tasques repetitives i connectem les teves aplicacions amb n8n, Power Automate, Make i RPA, eliminant treball manual i augmentant la productivitat.

Més info

Formació per a empreses

Formem els teus equips en tecnologia amb criteri: desenvolupament web, bases de dades, Git, bones pràctiques i seguretat, automatització amb n8n, intel·ligència artificial per a empreses i creació de solucions d'IA amb Azure AI Foundry.

Més info

Auditoria de codi

Auditem el codi que creguis tu, el teu equip o una IA: et diem què està bé i què millorar, el securitzem i el deixem llest per a producció, web o app.

Més info

Generació d'imatges amb IA

Creem per tu les imatges que necessita el teu negoci amb intel·ligència artificial: producte, xarxes, publicitat, il·lustració i avatars. Tu ens dius què vols i t'ho lliurem llest per fer servir.

Més info

Generació de vídeos amb IA

Creem per tu vídeos amb intel·ligència artificial: promocionals, per a xarxes, presentadors virtuals, doblatge i animacions. Ens comptes la idea i t'ho lliurem muntat i llest per publicar.

Més info

Avatars conversacionals amb IA

Creem avatars conversacionals amb IA —humans digitals amb cara i veu— que atenen els teus clients i equips amb el coneixement de la teva empresa, a la teva web, monitors interactius, WhatsApp o Teams.

Més info

Màrqueting Online i IA

Google Ads, Meta Ads, LinkedIn Ads i posicionament en motors d'IA (GEO/AEO): captem clients i fem que la teva marca aparegui on et busquen, també a ChatGPT, Gemini i Perplexity.

Més info

Tens un projecte en ment?

Explica'ns la teva visió i la convertim en una solució de programari. Sigui quin sigui l'abast, fem realitat la teva idea.

Live Chat