Skip to main content

限制額度

帳獸 API 依認證狀態套用不同的頻率限制:

Rate Limit Headers

每個 API 回應都包含以下標頭,告知你目前的頻率限制狀態:

回應範例

超過限制

當請求次數超過額度時,API 會回傳 429 Too Many Requests
回應會包含 Retry-After 標頭,告知你應等待的秒數:

處理策略

基本重試

最佳實踐

  • 監控剩餘額度:定期檢查 X-RateLimit-Remaining,在接近 0 時主動降速
  • 批次操作:使用批次 API(如 /customers/batch)一次處理多筆資料,減少請求次數
  • 快取資料:對於不常變動的資料,在客戶端快取以減少重複請求
  • 錯開請求:避免在短時間內發送大量請求,適當分散請求時間

計算範例

已認證請求的 3,600 次/小時限制代表:
  • 平均每秒可發送 1 次 請求
  • 平均每分鐘可發送 60 次 請求
實際使用中,短時間內的突發流量是允許的,只要一小時內的總量不超過限制即可。