Tema 14 · Rate Limiting

14. Rate Limiting Dinámico por Usuario y por IP con la Facade RateLimiter

Configura limitadores de tasa inteligentes en AppServiceProvider para otorgar cuotas diferenciadas según el plan (gratis vs premium) o por IP.

El Sistema de Rate Limiting de Laravel

Por defecto, las rutas de routes/api.php incluyen el middleware throttle:api, que restringe a 60 peticiones por minuto. Sin embargo, en aplicaciones SaaS reales necesitas aplicar reglas de cuota dinámicas según el rol o plan de suscripción del usuario.

Definición de Limitadores con RateLimiter::for()

En el método boot() de AppServiceProvider podemos definir limitadores nombrados con lógica condicional:

  • Los usuarios no autenticados (invitados) quedan limitados por su dirección IP ($request->ip()).
  • Los usuarios con cuenta Premium pueden tener 1.000 peticiones por minuto.
  • Los usuarios gratuitos tienen 100 peticiones por minuto.

⚡ Configuración de Rate Limiting Personalizado en AppServiceProvider

Ejemplo de limitador dinámico basado en planes de suscripción y uso en rutas:

RateLimiterSetup.php
Solo lectura
<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Illuminate\Support\Facades\RateLimiter;
use Illuminate\Cache\RateLimiting\Limit;
use Illuminate\Http\Request;

class AppServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        // 1. Limitador dinámico para la API
        RateLimiter::for('api-personalizada', function (Request $request) {
            $user = $request->user();

            if ($user && $user->plan === 'enterprise') {
                return Limit::none(); // Sin límites para cuentas Enterprise
            }

            if ($user && $user->plan === 'pro') {
                return Limit::perMinute(500)->by($user->id);
            }

            // Para usuarios estándar o invitados por IP
            return Limit::perMinute(60)->by($user?->id ?: $request->ip())->response(function () {
                return response()->json([
                    'status'  => 'error',
                    'code'    => 429,
                    'message' => 'Has alcanzado el límite de peticiones de tu plan. Actualiza a Pro para mayor capacidad.',
                ], 429);
            });
        });
    }
}

// -------------------------------------------------------------
// En routes/api.php:
// Route::middleware('throttle:api-personalizada')->group(function () {
//     Route::apiResource('reportes', ReporteController::class);
// });
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Dónde se definen formalmente los limitadores de tasa nombrados (RateLimiter::for()) en Laravel?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar APIs RESTful con Laravel, Resources & Sanctum y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.