速率限制
API 請求速率是否受限?
是的,Zencoder限制在給定時間範圍內可以調用特定方法的次數。系統會根據每個方法 (資源) 來追蹤限制 (例如,例如,GET
和POST
要求會分別追蹤),但進度要求除外,每個輸出都會追蹤這些限制。例如,獲取作業和輸出信息的調用都計入相同的限制,而輸出進度的調用則按輸出單獨跟踪。
每個賬戶每分鐘允許 60 個請求,但作業創建請求除外,它被限制為每分鐘 1,000 個請求,以及輸出進度請求,每個輸出被限制為每分鐘 60 個請求。
每個 HTTP 回應都包含一個名為 " X-Zencoder-Rate-Remaining
" 的標頭。此標頭列出了您在當前時間範圍內可以對給定資源進行的調用次數。
如果超出配額,Zencoder 將返回 403 錯誤,內文為「403 Forbidden (Rate Limit Exceeded)
」。我們也會傳回額外的標頭Retry-After
「」,其中包含重設配額前的秒數。
為什麼 API 請求速率受限?
我們將 API 請求限制在一個合理的數量,以確保一個客戶對 Zencoder 的使用不會對其他客戶產生不利影響。如果沒有速率限制,一個客戶可能會以一種阻止另一個客戶使用系統的方式向我們的系統發送請求。當客戶第一次使用 API 時,這種情況會定期偶然發生 - 一個簡單的編程錯誤可能會使 API 充滿客戶無意發送的請求。
只要您的應用程序設置正確,速率限制應該不是問題。當我們返回正文中包含“超出速率限制”的 403 時,只需在指定的時間段後重試您的請求即可。
如果您發現您經常遇到這些限制, 請聯繫我們 討論您的設置和選項。