Struct Limit 

pub struct Limit {
    pub max_requests: u32,
    pub window_seconds: u64,
    /* private fields */
}

Declarative rate limit configuration

Defines how many requests are allowed in a time window, with optional per-key segmentation and custom 429 responses.

Example

use ferro::middleware::Limit;

// 60 requests per minute, keyed by client IP (default)
let limit = Limit::per_minute(60);

// 120 requests per minute, keyed by user ID
let limit = Limit::per_minute(120).by(format!("user:{}", user_id));

// Custom 429 response
let limit = Limit::per_hour(1000).response(|| {
    HttpResponse::json(serde_json::json!({"error": "Quota exceeded"})).status(429)
});

Fields

max_requests: u32

Maximum requests allowed in the window

window_seconds: u64

Window duration in seconds

Implementations

impl Limit

pub fn per_second(max: u32) -> Self

Create a limit allowing N requests per second

pub fn per_minute(max: u32) -> Self

Create a limit allowing N requests per minute

pub fn per_hour(max: u32) -> Self

Create a limit allowing N requests per hour

pub fn per_day(max: u32) -> Self

Create a limit allowing N requests per day

pub fn by(self, key: impl Into<String>) -> Self

Set a custom key for rate limit segmentation

When set, this key is used instead of the client IP address. Useful for per-user or per-API-key rate limiting.

Example

Limit::per_minute(120).by(format!("user:{}", user_id))

pub fn response<F>(self, f: F) -> Self

where F: Fn() -> HttpResponse + Send + Sync + 'static,

Set a custom response for 429 Too Many Requests

Example

Limit::per_minute(60).response(|| {
    HttpResponse::json(serde_json::json!({"error": "Slow down!"})).status(429)
})

Trait Implementations

impl From<Limit> for LimiterResponse

fn from(limit: Limit) -> Self

Converts to this type from the input type.