Rate Limits
Disguise Cloud API enforces rate limits to ensure fair usage and to protect the system from abuse. Rate limits are applied per API token.
Rate Limit Policy
The rate limits for the Cloud API are as follows:
- Management API: 1000 requests per hour
- Spaces API: 1000 requests per hour
Please Note: If you exceed the rate limit, you will receive a 429 Too Many Requests response. You will need to wait until the rate limit resets before making additional requests. It is possible to be rate limited from one API instance and not the other, so you may still be able to make requests to the other API instance.
Rate Limit Headers
To manage your rate limits effectively, you can use the following headers provided in the API response:
| Header | Description | Values |
|---|---|---|
| X-RateLimit-Ring3-Status | Check this header to monitor the current status of your rate limit. | OK: You are within the rate limit. LIMITED: You have exceeded the rate limit. |
| X-RateLimit-Ring3-Reset | Check this header to get the reset time. | If the status is LIMITED, this will be a datetime string of when your rate limit resets, otherwise this will be empty |
By using these headers, you can determine when you can make additional requests to the API.
Handling Rate Limit Exceeded Errors
If you receive a 429 Too Many Requests response, you should:
- Reduce the frequency of your requests.
- Implement exponential backoff in your code to retry requests after a delay.
- Contact support if you believe you need a higher rate limit for your use case.
By adhering to these guidelines, you can ensure that your applications interact smoothly with the Disguise Cloud API without interruption.