To prevent system abuse and ensure API stability, we require partners to operate within certain rate limits. Once a rate limit has been exceeded, no more requests are handled until the limit expires.
The expected limit is 5 ARI requests per minute per property.
Best practice to avoid rate limit:
Verify that your requests include the x-api-key in headers
Include a queuing system.
Perform exponential backoff when a rate limit is exceeded.
Channex we can handle up to 10mb per json call, so make sure you send all your data efficiently. A full sync would be 2 API calls, it should be very easy to keep each property to be under 5 api calls per minute for availability or rates.
1: Avoid Hitting Rate Limits
There are several ways to avoid hitting the rate limits, the most used are queues and CRON jobs to batch updates.
2: Throttle Your Requests
Within your queue system, there should be a throttling system in place to space out the number of requests. Throttling allows for more control over the number of requests that can be processed reducing the chances to hit the limit.
3: Exponential Back-off
Exponential backoff is an algorithm that increases the time for retrying requests based on the number of failed requests you receive due to a rate limit.