速率限制
为确保服务的稳定性和公平性，TurningAPI 对 API 请求频率进行了限制。
限制概览
60
请求/分钟
基础版
300
请求/分钟
专业版
1000+
请求/分钟
企业版
响应头信息
每个 API 响应都会包含以下速率限制相关的 Header：
| Header | 描述 |
|---|---|
X-RateLimit-Limit | 当前时间窗口内允许的最大请求数 |
X-RateLimit-Remaining | 当前时间窗口内剩余的请求次数 |
X-RateLimit-Reset | 速率限制重置的 Unix 时间戳 |
响应示例
HTTP Headers
HTTP/1.1 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1704556800
Content-Type: application/json处理限流
当请求超出限制时，API 会返回 429 状态码：
429 Response
{
"code": 42901,
"message": "Rate limit exceeded",
"retry_after": 30
}推荐的重试策略
- • 使用
retry_after字段确定等待时间 - • 实现指数退避：初始 1s，最大 32s
- • 添加随机抖动避免惊群效应
- • 最多重试 3 次
最佳实践
批量请求
使用批量 API 端点减少请求次数
缓存结果
在客户端缓存不常变化的数据
监控用量
通过控制台监控 API 调用量，避免突发流量