Why do I get an error message in my tool that my requests are throttled?

To prevent you from putting too much load on your own cloud system, too frequent requests are throttled.
The reason for this is that too frequent requests that are not necessary can have a negative impact on your workflows

Currently, the following requests are throttled and limited to:
Functionality Throttling rate API Uri
Account logons 10 calls per minute Account/Logon
File cabinet description request 60 calls per minute FileCabinets/Index

That means e.g., if one client tries to log in more than 10 times in a minute, the 11th login request will be throttled.
Throttling means:

  • Normally a request is served in a few milliseconds. If a request is throttled, then the response is sent after 10 seconds
  • The HTTP status 429 will be returned

Example Screenshot:

If you are receiving an HTTP status 429, please check your platform application carefully.
An optimized platform application will help you and all other DocuWare users to get a faster response from your DocuWare Cloud System.

Please be aware that the throttling will only apply to SDK tools that are connecting to the DocuWare platform. Actions within the web client done by a user, will not be throttled.

If a platform application is using the same DocuWare user login as a DocuWare client (e.g. Desktop App) and the visible IP address for the DocuWare server is the same, then it might also happen, that the DocuWare client is throttled. 
The Reason is, that the application server counts all requests of one DocuWare user + IP address per time slice. So if for example the platform application already requested 60 times “FileCabinets/Index” in a minute time slice and then the Desktop App also tries to get this information, then the Desktop App is throttled. So it’s important, that all platform applications are programmed carefully to avoid further problems or side effects.

Comments (0)