請求頻率限制

限制以每個 API 金鑰為單位計算。所有已認證的端點共用以下時間窗口：

時間窗口	限制
每分鐘	60 個請求
每小時	1,000 個請求

建立匯出的成本較高，因此 POST /exports 每個金鑰額外有每小時 5 個請求的限制。

請求頻率限制標頭

每個已認證的回應都會回報目前的限制狀態：

API 回傳 429 及代碼 rate_limited，並附上 Retry-After 標頭（可重試前的等待秒數）：

{
  "success": false,
  "error": "Rate limit exceeded",
  "code": "rate_limited",
  "request_id": "req_..."
}

等待至 Retry-After 時間過後再重試。建議的用戶端行為是採用指數退避並遵守 Retry-After 的值。

除了請求頻率限制標頭外，每個回應還包含：

標頭	說明
`X-Request-ID`	唯一請求識別碼——在提交支援請求時請附上此值
`X-API-Version`	處理此請求的 API 版本（`2026-07-01`）