Chapter 5. Provisioning Rate Limits

Rate limits allow you to throttle access to your API resources. You can configure different limits for separate developer segments through the use of application plans.

Once you have rate limits in place, these limits will control the responses a developer receives when they make authorization request calls to the 3scale back end.

5.1. Step 1: Go to the application plan

If you do not have an application plan defined yet, create one first. Otherwise, select the plan you want to set rate limits for and click edit.

Rate limits

5.2. Step 2: Set the rate limits

New usage limit

5.3. Step 3: Update the application plan

When you are finished setting the limits you require, save your changes by clicking Update Application plan.

5.4. Step 4: Put the new rate limits into action

Now that you have your rate limits defined, the following will happen:

  • If you have alerts configured, the new limits will be used to decide when notifications are sent.
  • When you make authorization calls to the 3scale back end, the limits will be taken into account and the response will be with status code 409. In this case the APIcast API gateway sends a response to the client with the status code 429 Too Many Requests and the message, Limits exceeded.

Once your rate limits are operational, you will see the users who are reaching the limits on your dashboard, making it quick and easy to check for potential plan upgrade candidates.

Note

For more information about soft and hard limits, you should read 1.1.3.2. Configure your API access policies with application plans, window="_blank" in our Quickstart guide.

Dashboard messages

5.5. More information

Besides setting rate limits, you can also set variable pricing rules for the same metrics – see provision paid plans