速率限制

為確保公平使用及系統穩定，我們的 API 實作了速率限制。不同的訂閱方案有不同的速率限制。

方案額度

每月額度取決於你的方案。這是所有產品共用的一份額度，每一次計量呼叫在其中計一次。

Free：每月 30,000 次請求，平均約每日 1,000 次，而且沒有每日上限。

付費方案： Starter 每月 150,000 次，Pro 每月 500,000 次，Business 每月 2,000,000 次。Enterprise 不限量。

示範端點：無需密鑰的示範端點對每個 IP 位址每日允許約 100 次請求，無需註冊。

GET /v1/demo/{ip}

速率限制標頭

所有 API 回應均包含可提供目前速率限制狀態資訊的標頭：

X-RateLimit-Limit: 目前時間範圍內允許的最大要求數

X-RateLimit-Remaining: 目前時間範圍內剩餘的要求數

X-RateLimit-Reset: 速率限制範圍重設的時間（Unix 時間戳記）

超出速率限制

如果你超出速率限制，API 將傳回 429 Too Many Requests 回應，內容如下：

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please try again later.",
  "retryAfter": 60
}

最佳實務

實作退避策略：當你收到速率限制錯誤時，請在重試前實作指數退避。

快取回應：盡可能快取 API 回應，以減少要求次數。