A rate limit is the number of API requests an integration partner can do within a given time period. If this limit is exceeded, further API requests will be blocked. All API requests are subject to rate limits.

Each integration partner is granted a default rate limit. Contact [email protected] if the default rate limit is not sufficient. 

There are two different values used to calculate the rate limit.

  • Replenish rate
    • The number of API requests replenished each second.
  • Burst capacity
    • Burst capacity is the maximum number of requests in a single second. It allows temporary bursts of requests while decreasing the available requests for the upcoming seconds.

For example, with a replenish rate of 2 and burst capacity of 10, a steady rate of 2 requests / second is possible. If a partner sends ten requests during a single second, the capacity for the upcoming 4 seconds is used, and requests will be blocked for that time period.

When the rate limit is exceeded, the API will respond with HTTP 429 - Too Many Requests.

Response headers

X-RateLimit-Remaining

The number of API requests remaining within the time cycle (one second).

X-RateLimit-Replenish-Rate

The replenish rate.

X-RateLimit-Burst-Capacity

The burst capacity.

 



Oliko tästä vastauksesta apua? Kyllä Ei

Send feedback
Pahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.