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:
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: 16The following table shows the four variants of this field and their descriptions:
