Rate Limiting
To ensure system stability and fair usage for all developers, the Lumino API enforces strict rate limits on all incoming requests.
Technical Overview
The core functionality of this module relies on the distributed nature of the Lumino backend. It is designed for high availability and low latency access.
Default Limit
100 req / min
Response Headers
Every API response includes headers that describe your current rate limit status.
Header
Description
X-RateLimit-Limit
The maximum number of requests allowed per minute.
X-RateLimit-Remaining
The number of requests remaining in the current window.
X-RateLimit-Reset
The time at which the current rate limit window resets (UTC).
Throttling Error
When the limit is exceeded, the API returns a429 Too Many Requestsstatus code.
json
Coppied
1{
2 "error": "rate_limit_exceeded",
3 "message": "You have reached the maximum of 100 requests per minute.",
4 "retry_after": 42
5}
Best Practices
• Implement exponential backoff in your client logic.
• Cache common API responses locally to reduce outbound calls.
• Monitor the X-RateLimit-Remaining header to self-throttle.
• Cache common API responses locally to reduce outbound calls.
• Monitor the X-RateLimit-Remaining header to self-throttle.
