频率限制与错误

了解频率限制、响应头和错误码。

各方案频率限制

方案	每日限制	突发限制
Free	200	1 req / 3s
Trader	10,000	1 req / s
Business	100,000	3 req / s

响应头

每个 API 响应都包含频率限制响应头，方便你追踪用量。

X-RateLimit-Limit当前时间窗口内允许的最大请求数。

X-RateLimit-Remaining当前时间窗口内剩余的请求数。

最佳实践

•缓存响应 — 卡牌数据和价格不会每秒变化，请至少缓存 5 分钟。
•使用批量查询 — 使用 ids 参数每次请求最多获取 20 张卡牌，而非单独调用。
•实现指数退避 — 当遇到 429 错误时，等待并以递增延迟重试（1s、2s、4s）。
•监控频率限制响应头 — 检查 X-RateLimit-Remaining，在达到限制前主动降速。