README.md

 ______  __ __  ____    ___   ______  ______  _        ___  ____   ____  ____   ___   
|      T|  T  T|    \  /   \ |      T|      T| T      /  _]|    \ l    j|    \ |   \  
|      ||  l  ||  D  )Y     Y|      ||      || |     /  [_ |  o  ) |  T |  D  )|    \ 
l_j  l_j|  _  ||    / |  O  |l_j  l_jl_j  l_j| l___ Y    _]|     T |  | |    / |  D  Y
  |  |  |  |  ||    \ |     |  |  |    |  |  |     T|   [_ |  O  | |  | |    \ |     |
  |  |  |  |  ||  .  Yl     !  |  |    |  |  |     ||     T|     | j  l |  .  Y|     |
  l__j  l__j__jl__j\_j \___/   l__j    l__j  l_____jl_____jl_____j|____jl__j\_jl_____j

Throttlebird

Throttlebird is a simple http request throttler to help limit the number of client requests within a given period of time.

Example

In your WebApiConfig file under the App_Start folder of your ASP.NET MVC project, add the following code block within the Register method:

// Implement our custom throttling handler to limit API method calls.
// Specify the throttle store, max number of allowed requests within specified timespan,
// and message displayed in the error response when exceeded.
config.MessageHandlers.Add(new ThrottlingHandler(
    new InMemoryThrottleStore(),
    id => 3,
    TimeSpan.FromSeconds(5),
    "You have exceeded the maximum number of allowed calls. Please wait until after the cooldown period to try again."
));

This works across all http requests on your site, limiting the number of requests to 3 every 5 seconds. To adjust, simply modify the id parameter to the number of requests, and the timespan to any valid TimeSpan value (FromSeconds, FromMinutes, etc.) to the values that work for you.

More to Come

This is the the first iteration of this library. Future expansions will allow you to selectively apply throttling on specific controller actions through the use of attributes.