節流最佳做法

HTTP/1.1 429 Too Many Requests
Retry-After: 8

{ 
  "code": 429, 
  "status": "TooManyRequests", 
  "retryAfterSeconds": 8, 
  "error": "APIClientRequestRateLimitExceeded", 
  "errorCode": 1199, 
  "errorMessage": "The client has exceeded the maximum API request rate and is being throttled" 
} 

​

緩解節流問題

1. 檢閱要求速率
   • 分析您為何傳送大量要求。
   • 評估降低 API 所針對之特定玩家或遊戲實體要求速率的方法。
   • 若要查看哪些 API 和呼叫端正在接近或已達到限制，請檢查 api_rate_limit_alert 事件 (預覽)。
2. 批次處理 API 呼叫
   • 透過批次處理 API 呼叫來降低頻率。
   • 範例：每 10 秒批次處理一次設定檔更新，而不是每秒更新一次。

​

重點摘要

• 節流錯誤會引發 HTTP 429 回應，並附有錯誤性質的詳細資料。
• 使用 Retry-After 和 “retryAfterSeconds” 屬性來決定發出另一個要求之前的等候時間。
• 評估高頻率要求的必要性並據此進行最佳化。
• 實作批次處理策略，以減輕節流問題並提升整體系統效率。

​

另請參閱

• Economy v2 限制