Class: Rack::Throttle::PerMinute

Inherits:
TimeWindow show all
Defined in:
lib/rack/throttle/per_minute.rb

Overview

This rate limiter strategy throttles the application by defining a maximum number of allowed HTTP requests per minute (by default, 60 requests per minute, which works out to an average of 1 request per second).

Note that this strategy doesn't use a sliding time window, but rather tracks requests per distinct minute. This means that the throttling counter is reset every minute on the minute (according to the server's local timezone).

Examples:

Allowing up to 3,600 requests per minute

use Rack::Throttle::PerMinute

Allowing up to 100 requests per minute

use Rack::Throttle::PerMinute, :max => 100

Instance Attribute Summary

Attributes inherited from Limiter

#app, #options

Instance Method Summary collapse

Methods inherited from TimeWindow

#allowed?

Methods inherited from Limiter

#allowed?, #blacklisted?, #cache, #cache_get, #cache_has?, #cache_set, #call, #call_on_reject, #client_identifier, #http_error, #http_status, #rate_limit_exceeded, #request_start_time, #whitelisted?

Constructor Details

#initialize(app, options = {}) ⇒ PerMinute

Returns a new instance of PerMinute.

Parameters:

  • app (#call)
  • options (Hash{Symbol => Object}) (defaults to: {})

Options Hash (options):

  • :max (Integer) — default: 3600


24
25
26
# File 'lib/rack/throttle/per_minute.rb', line 24

def initialize(app, options = {})
  super
end

Instance Method Details

#cache_key(request) ⇒ String (protected)

Parameters:

  • request (Rack::Request)

Returns:

  • (String)


39
40
41
# File 'lib/rack/throttle/per_minute.rb', line 39

def cache_key(request)
  [super, Time.now.strftime('%Y-%m-%dT%H%M')].join(':')
end

#max_per_minuteObject Also known as: max_per_window



28
29
30
# File 'lib/rack/throttle/per_minute.rb', line 28

def max_per_minute
  @max_per_minute ||= options[:max_per_minute] || options[:max] || 60
end