TsgcWSRateLimiter › Properties

TsgcWSRateLimiter Properties

Published properties grouped by purpose, followed by the full alphabetical list.

Core

NameDescription
EnabledMaster switch that turns the entire rate limiter on or off.

Algorithms

NameDescription
TokenBucketToken Bucket algorithm configuration: capacity plus refill rate for smooth bursts.
SlidingWindowSliding Window algorithm configuration: MaxRequests over a rolling WindowSec.
FixedWindowFixed Window algorithm configuration: MaxRequests inside a clock-aligned WindowSec.
BurstProtectionShort-timescale spike detector that puts abusive keys into a cooldown.

Scoping

NameDescription
PerIPRate-limit rule scoped to the source IP address.
PerAPIKeyRate-limit rule scoped to an API-key identifier (keys prefixed apikey:).
PerUserRate-limit rule scoped to a user identifier (keys prefixed user:).
PerEndpointCollection of pattern-based rules matched by wildcard against the request key.
QuotasLong-term caps (hour/day/month) evaluated on top of the main strategy.

Response

NameDescription
ResponseShape of the HTTP response returned for throttled requests (status, body, headers).

Persistence

NameDescription
StorageFileOptional file path used by the state-persistence methods.

Diagnostics

NameDescription
StatsRead-only counters with live statistics about evaluated and throttled requests.

All Properties (alphabetical)

NameDescription
BurstProtectionShort-timescale spike detector that puts abusive keys into a cooldown.
EnabledMaster switch that turns the entire rate limiter on or off.
FixedWindowFixed Window algorithm configuration: MaxRequests inside a clock-aligned WindowSec.
PerAPIKeyRate-limit rule scoped to an API-key identifier (keys prefixed apikey:).
PerEndpointCollection of pattern-based rules matched by wildcard against the request key.
PerIPRate-limit rule scoped to the source IP address.
PerUserRate-limit rule scoped to a user identifier (keys prefixed user:).
QuotasLong-term caps (hour/day/month) evaluated on top of the main strategy.
ResponseShape of the HTTP response returned for throttled requests (status, body, headers).
SlidingWindowSliding Window algorithm configuration: MaxRequests over a rolling WindowSec.
StatsRead-only counters with live statistics about evaluated and throttled requests.
StorageFileOptional file path used by the state-persistence methods.
TokenBucketToken Bucket algorithm configuration: capacity plus refill rate for smooth bursts.