文件
Rate Limit 與配額
說明請求速率、配額控管與高併發整合策略。
概念說明#
Rate limit 控制單位時間請求速率；配額控制方案期間內可用總量。
兩者需同時考慮，否則即使短期流量正常，仍可能觸發總量限制。
TWSE/TPEx 日價端點目前採每組 API key 每分鐘 60 次限制。
適用情境#
高頻查詢、批次回補與多服務共享同一組金鑰時，最容易觸發限制。
建議在 client 端實作併發池與請求節流策略。
實作重點#
建議在 SDK 或 API gateway 層統一處理 429 與重試間隔，避免每個服務重複實作。
搭配本地快取、批次聚合與增量查詢可顯著降低請求量。
- 使用 exponential backoff
- 設定最大重試次數
- 重試前檢查剩餘配額與業務時效
注意事項#
不要在短時間以固定間隔盲目重試，這通常會放大擁塞。
建議在控制台設定告警門檻，於接近配額時提前降載。