REST API Web Services Usage Limits
In Documoto, throttling is a mechanism to ensure the stability and integrity of the application by regulating the the number of API requests users can make within a specific timeframe. Understanding this process is essential for users to manage their API usage effectively and contribute to the smooth functioning of the system.
Article Topics
Throttling Limits
In Documoto, each customer's API usage is governed by their Subscription Plan, which determines the allowed number of requests within a one-hour timeframe. To enforce this limit effectively, Documoto employs throttling based on five-minute intervals.
Determining Throttling Intervals
To determine the throttling intervals, Documoto divides the hourly request limit by twelve, resulting in five-minute intervals - see table below:
| Throttle Limit - Hourly | Throttle Limit - 5 Minutes | Response Message for Exceeding Either Limit |
| 5,000 | 416 | Due to system load, we are throttling publishing, indexing and API activities. |
| 10,000 | 833 | Due to system load, we are throttling publishing, indexing and API activities. |
| 20,000 | 1,666 | Due to system load, we are throttling publishing, indexing and API activities. |
Throttling Process
Documoto continuously monitors API requests, checking every ten seconds to see if the request count exceeds the limit for the current five-minute interval. If the limit is surpassed, subsequent requests are throttled until the end of the five-minute interval. Once the five-minute interval concludes, users can resume submitting requests.