速率限制
Conviction 公共 API 实施速率限制，以确保服务稳定性和所有用户的公平访问。
当前限制
| 层级 | 速率限制 | 描述 |
|---|---|---|
| 公共 | 100 请求 / 10 秒 | 所有未认证请求的默认限制 |
速率限制响应头
响应包含速率限制信息：
| 响应头 | 描述 |
|---|---|
X-RateLimit-Limit | 每个窗口的最大请求数 |
X-RateLimit-Remaining | 当前窗口剩余请求数 |
X-RateLimit-Reset | 窗口重置的 Unix 时间戳 |
超出速率限制
超出速率限制时，API 返回 429 Too Many Requests 响应：
{
"statusCode": 429,
"message": "Too many requests, please try again later"
}
最佳实践
- 尽可能缓存响应
- 使用
limit和offset分页，而不是一次获取所有数据 - 避免过于频繁的轮询——考虑使用 webhooks（即将推出）