article

Miguel avatar image
Miguel Posted · · edited ·

Improved 429 response headers

Along with our recent rate limit updates, we at Clover are introducing improved 429 response headers based on your feedback.

With these improvements, you can better understand:
  • The type of rate limit that your app reached
  • Your app’s current rate limit value
  • The duration you are required to wait until your app can make additional requests

This information is found in two key-value fields: retry-after and X-RateLimit-{type}

retry-after

The retry-after field specifies the number of seconds you are required to wait before your app can make any additional requests. If your app makes additional requests before this time expires, the waiting period increases.

Example response:
retry-after: 21

X-RateLimit-{type}

There are four variants of the X-RateLimit-{type} field, depending on the type of rate limit that has been reached. In addition to specifying the type of rate limit reached, this key informs you of your app’s current rate limit value. You should always keep your requests under the rate limit value.

Example response:
X-RateLimit-tokenLimit: 16
The following table shows the four variants of this field and their descriptions:


REST APIrate limits
10 |2000 characters needed characters left characters exceeded

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Welcome to the
Clover Developer Community

Article

Contributors

miguel contributed to this article

Related Articles