Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

This web service allows users to test rate limits for the following web services:is provided so that developers may test that their code properly handles Rate Limit errors from Projector.

In its simplest invocation, this service will simply respond with current “at this moment in time” counts in use by the rate limiter for the current user, current session, and current installation (account), as well as the thresholds that are in use by the limiter.

The service may also be used to simulate additional “hits” to land at the server either before or after counts are applied to the limiting algorithm is brought to bear.

Note

WARNING: If you use this service to simulate hits, those hits will remain part of the algorithm for this and all other services that are invoked before the rolling window expires.

Info

Rate Limiting

In order to protect our servers from inadvertent service overuse or intentional attack, and to fairly distribute services to all our customers, we have implemented a rate limiting algorithm.  When fully deployed, this new algorithm will cause services to either succeed with new warnings or fail with new errors when services are consumed at too high a rate.  Programs that consume Projector services should be enhanced to handle rate limiting errors so that they can continue functioning properly.  For more information please visit: Projector Rate Limiting Behavior.

Request Format

  • PwsTestRateLimiter

    • serviceRequest: PwsTestRateLimiterRq

      • RequestId: Int32

      • SessionTicket: String

      • SimulateInstallationHitsAfter: Int32

      • SimulateInstallationHitsBefore: Int32

      • SimulateSessionHitsAfter: Int32

      • SimulateSessionHitsBefore: Int32

      • SimulateUserHitsAfter: Int32

      • SimulateUserHitsBefore: Int32

...

Element

Data Type

Required?

Default

Description

Sample Data

RequestId

Int32

No

Click here for more information.

1

SessionTicket

String

Yes

Click here for more information.

AYecIQSsKNpDZ6wY4k5Ilw==

SimulateInstallationHitsAfter

Int32

No

Simulate this many installation hits AFTER application of limiting algorithm.

500

SimulateInstallationHitsBefore

Int32

No

Simulate this many installation hits BEFORE application of limiting algorithm.

1500

SimulateSessionHitsAfter

Int32

No

Simulate this many session hits AFTER application of limiting algorithm.

200

SimulateSessionHitsBefore

Int32

No

Simulate this many session hits BEFORE application of limiting algorithm.

1000

SimulateUserHitsAfter

Int32

No

Simulate this many user hits AFTER application of limiting algorithm.

1000

SimulateUserHitsBefore

Int32

No

Simulate this many user hits BEFORE application of limiting algorithm.

1000

Request Usage Example(s)

...