报告服务 API 会应用速率限制来保护服务可用性并确保各客户端的公平使用。
速率限制适用于每个源 IP 地址。
限制
报告服务 API 请求受以下限制：
| 限制 | 值 |
|---|---|
| 最高速率 | 每个源 IP 地址每秒 50 个请求 |
| 突发配额 | 每个源 IP 地址 100 个请求 |
可以接受高于稳定状态速率的短时间突发流量，但突发容量取决于请求的路由方式。如果多个客户端共用同一个 NAT 网关或代理，这些客户端的源 IP 地址限制也相同。
超出限制
如果超出速率限制，API 会返回 429 请求过多状态。请稍等片刻再重试请求。
要降低收到 429 响应的概率：
- 限制来自同一源 IP 地址的并发请求。
- 使用带指数退避和抖动的重试逻辑。
- 避免在紧密循环中立即重试失败的请求。