API 每分鐘有速率限制,並且不同資源依客戶賬戶有不同的限制。假定一個資源的速率限制為每分鐘 10 次請求;在同一分鐘內(例如在 16:20:00 至 16:21:00 之間),任何超過 10 次的請求都會傳回錯誤。速率限制器允許突發,例如,如果在前 50 秒內沒有收到任何請求,但在接下來的 10 秒內收到 10 次請求,那麼所有請求都會成功。
您必須在 API 客戶端針對 HTTP 429 回應代碼實施適當的錯誤處理。使用帶有隨機抖動的指數倒退演算法是處理 HTTP 429 回應代碼的推薦方法。
根據 API 客戶端是否發出經身份驗證的請求,不同的速率限制適用於不同的資源,如下所示。
請求類型 | 請求路徑 | 速率限制(生產) | 速率限制(演示) |
---|---|---|---|
身份驗證 | /v2/authenticate/api |
每分鐘 60 次請求 | 每分鐘 60 次請求 |
匯率請求 |
/v2/rates/find , /v2/rates/detailed
|
每分鐘 200 次請求 | 每分鐘 150 次請求 |
所有其他經身份驗證的請求 | /v2/* |
每分鐘 500 次請求 | 每分鐘 150 次請求 |
所有其他未經身份驗證的請求 | /v2/* |
每分鐘 200 次請求 | 每分鐘 200 次請求 |
超出速率限制
當超出速率限制時,API 將傳回 HTTP 狀態代碼 429——「請求過多」,並附有 JSON 回應正文,如下例所示:
HTTP/1.1 429 請求過多 日期:2021 年 1 月 25 日星期一 13:16:59 GMT Content-Type: application/json; charset=UTF-8 { "error_code": "too_many_requests", "error_messages": { "base": [ { "code": "too_many_requests", "message":"Too many requests have been made to the api.Please refer to the Developer Center for more information", "params": {} }, ] } }
您應該等待 60 秒再重試請求。
不同的要求
如果您有不同的要求,請聯絡我們的團隊,以便我們能更好地滿足您的需求。