速率限制

請求速率

限制以每把 API 金鑰為單位計算，數值由工作區的方案決定。每把金鑰都有每秒上限（以一秒為單位的滑動視窗），以及在 UTC 午夜重置的每日配額。主控台的工作階段不受速率限制。

因缺少權限範圍或模組而被拒絕的請求（403）不會計入；只要通過身分驗證的請求，無論結果為何都會計入。

標頭

每個通過限流器的回應都會附上剩餘額度。X-RateLimit-Limit 與 X-RateLimit-Remaining 描述每秒視窗；當金鑰設有每日配額時，還會出現 Daily 這一組標頭。

HTTP/2 200X-RateLimit-Limit: 20X-RateLimit-Remaining: 19X-RateLimit-Daily-Limit: 100000X-RateLimit-Daily-Remaining: 98431

429 回應的樣子

被限流的請求會回傳 429、錯誤碼 rate_limit_exceeded、標準錯誤格式，以及以整數秒表示的 Retry-After 標頭。請至少等待該秒數後再重試；若再次被限流，請以指數退避方式拉長間隔。

HTTP/2 429Content-Type: application/jsonRetry-After: 1 {"code":"rate_limit_exceeded","message":"API key rate limit exceeded.","requestId":"3f2b6c1e-…","retryable":true}

每日配額用完時會回傳 429、錯誤碼 daily_quota_exceeded，以及倒數至 UTC 午夜的 Retry-After。429 回應本身不會附上配額標頭。

點數

與請求速率無關，每次讀取都會從工作區錢包以點數計費。快取讀取很便宜；需要收集新資料的請求則花費較多（請參閱點數）。達到上限後，所有計費的呼叫（包括快取讀取）都會回傳 402 與錯誤碼 credit_cap_exceeded。