The maximum number of API calls that you can make within a specific time period is called a rate limit. Hevo establishes a rate limit for all its public APIs to ensure resource availability for all users, prevent the denial of service (DoS), and contain the impact of any cascading failures. These APIs may include:
- Public APIs provided by Sources to access and ingest data.
- Public APIs provided by Destinations to load data.
- Hevo public APIs for performing different actions in the Hevo platform. Read API Docs to know more about the different APIs that Hevo offers.
Hevo allows a maximum of 100 requests to the public APIs per minute per user. This means that in any 60-second window, you can make up to 100 API calls.
If the API rate limits is exceeded, Hevo displays the error message: Request rate limit exceeded, and rejects any new API requests. You must wait for the limit to reset before you can make your next API request.
The following best practices can help you avoid exceeding the API rate limit:
- Batching multiple requests: You can group multiple API calls into batches to reduce the chances of exceeding the API rate limit. For example, a batch of 50 API calls containing 30 Source, 10 Destination, 10 Hevo API calls count as 50 calls and each call within this batch contributes to utilization of resources in a similar manner.
- Implementing a rate limiting algorithm: You can implement an algorithm that limits the number of API calls that you can make in a specific time interval. For example, Token Bucket and Leaky Bucket rate limiting algorithms.