Rate limiting

The RetailVista REST API does implement rate limiting. At this moment we support 30 method calls per minute. After reaching this number of requests, the rate limiter will throw a 429 errorcode. It's highly advised to catch this error code and take belonging measures (like waiting). A good approach we advice is always wait 2 seconds before executing a next API request. By doing so, it's impossible to execute more as 30 requests per minute and you will never reach a 429 error.

In the future we will extend the rate limiting functionality, their will be different limits depending on certain endpoints, and also limits for verbs like POST, GET, PUT etc. By catching the 429 error, future adjustments in our rate limiting parameters will not affect your application integration. So even when using 2 seconds per request, we still strongly advice to catch rate limiting errors.

The whole rate limiting approach is currently based on your public IP address. In the near future this will shift to the API token used.