速率限制
Engine ≥ 4.143.0. 每次令牌响应都包含签发时店铺策略中的 data.rate_limits。所有密钥共享这些额度；获取新令牌不会重置额度。套餐变更可能在令牌过期前生效。
- read_per_minute
- 每分钟读取请求数。
- write_per_minute
- 每分钟写入请求数；该值不授予写入权限。
- auth_per_minute
- 每分钟令牌请求数，包括失败的身份验证尝试。
请均匀发送请求；读取限额为正数时，两次读取之间至少间隔 60 / read_per_minute 秒。限额不保证同时接受同等数量的请求。其他集成也共享额度，请处理 429 和 Retry-After。
零表示不可用，而不是无限制。
每分钟限额
| 最低套餐 | 读取 · GET |
|---|---|
| BASIC | 60 |
| STANDARD | 120 |
| PROFESSIONAL | 300 |
| ADVANCED | 900 |
- 写入
- 10
- 身份验证
- 10
同一商店的所有密钥共享这些限额。
请求
- 读取和写入流量受商店当前 API 策略约束。
- 不同密钥不会各自获得无限容量。
- 请限制并发，在适合时缓存参考数据，避免反复读取未变化的详情记录。
429 · Retry-After
- 当 API 返回 429 和 rate_limit.exceeded 时，至少等待 Retry-After 指定的秒数，并增加随机延迟后再重试。
- 429 · capacity.queue_full — API 短队列已满；请求尚未开始执行。 429 · capacity.wait_timeout — API 队列等待超时；请求尚未开始执行。 至少等待 Retry-After 秒，并增加随机延迟。重试写入时保留原始密钥和请求内容。
- 请依据文档中的错误代码和响应头处理，不要猜测固定重试间隔。