速率限制
速率限制使租户性能保持可预期。它们按 API 密钥在固定的 60 秒窗口内应用。
层级
| 层级 | 每分钟请求数 |
|---|---|
standard（默认） | 120 |
elevated | 600 |
你的密钥层级及当前额度由 GET /v1/auth/context（rate_limit_tier）和 GET /v1/usage（rate_limit.limit_per_minute 与 rate_limit.remaining_per_minute）报告。请始终读取实时值，而非硬编码。
当你超出限制时
超出限制的请求会返回 429 并带有 code: "RATE_LIMITED"。请退避，并在窗口重置后重试。
在限制内进行设计
- 缓存参考数据，并优先使用增量同步而非全表轮询。
- 使用 Webhook 进行事件驱动更新，而非轮询。
- 在
429时退避，并避免在瞬时失败后出现并行重试风暴。 - 组合过滤器（
search、status、module）以减少抓取量。