速率限制
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 秒，並增加隨機延遲。重試寫入時保留原始金鑰和請求內容。
- 請依據文件中的錯誤代碼和回應標頭處理，不要猜測固定重試間隔。