Rate Limiting
To ensure a fair and reliable usage of the Clasp API, we enforce a rate limiting policy. This policy helps protect against excessive requests that could affect service quality.
Standard Throttling
Requests Limit: Partners are allowed up to 25 requests per second across all their API keys. Concurrency Limit: A maximum of 50 concurrent requests per partner is enforced to prevent overload.
Handling Limits
When a request exceeds the allowed rate, a 429
HTTP status code is returned, indicating that the request has been throttled. The response provides details on when to retry:
Additionally, the Retry-After
header offers the exact wait time before the next request attempt, simplifying automated retry logic.
Strategies for Managing Limits
Proactive Throttling: Clients should monitor their request frequency to stay within the imposed limits.
Automated Retries: Implementing automatic retries with respect to the Retry-After
timeframe is recommended for handling 429
responses efficiently.
Exceeding Limits
In scenarios requiring higher limits (e.g., bulk operations), partners should contact Clasp developer support to discuss a limit increase. Our goal is to accommodate valid use cases while maintaining system integrity and performance.
This rate limiting policy aims to protect both Clasp and its partners from potential issues arising from excessive API calls, ensuring a stable and responsive service for all users.