To prevent abuse, the Uberflip API uses rate-limiting. There is currently a single rate limit, which applies per set of API credentials (i.e. API Key/Secret pair) and is set at 750 requests/hour.
If you exceed the rate limit, the API will return a 429 Too Many Requests response. We recommend writing your code to gracefully handle receiving a 429 response.
Avoiding 429 Responses
To avoid being affected by rate-limiting, we recommend designing your app to cache data returned by the API whenever possible.
To help you anticipate and avoid 429 responses, every response sent by the Uberflip API includes the following headers:
| Header | Description |
|---|---|
X-Rate-Limit-Limit | The maximum total number of requests you can make per set of API credentials within the current rate limit time window. |
X-Rate-Limit-Remaining | The number of requests you can still make (with the current API credentials) within the current rate limit time window. |
X-Rate-Limit-Reset | The time at which the current rate limit time window will reset, given in UTC Unix Epoch time. |