Rate Limiting
How the API handles rate limiting.
|
Overview
The BlueAI API applies rate limiting to protect service stability. When you exceed the rate limit, the API returns a 429 Too Many Requests response.
Rate Limit Headers
Rate limit information is included in response headers:
| Header | Description |
|---|---|
| X-RateLimit-Limit | Maximum requests per window |
| X-RateLimit-Remaining | Remaining requests in current window |
| Retry-After | Seconds to wait before retrying (only on 429) |
Best Practices
- Implement exponential backoff when receiving 429 responses
- Cache responses where possible to reduce API calls
- Use bulk endpoints when available instead of individual requests
- Monitor the
X-RateLimit-Remainingheader proactively