RATE_LIMITED

問題

API 金鑰在 10 秒的時間窗內，向 createImage 或簽署網址傳送了超過 100 個請求。API 會回傳狀態 500，訊息為 You are rate limited, please wait until 後面接一個時間。這個時間是以毫秒為單位的 Unix 時間戳記。

PDF 和已儲存檔案的端點，會用 TOO_MANY_REQUESTS 回報相同的狀況。計數器依 API 金鑰和端點群組分別計算，群組清單請見配額與上限。

解決方式

等到訊息中的時間之後，再重新傳送請求。createImage、createPdf 和簽署網址的回應都帶有 RateLimit-Remaining 標頭和 RateLimit-Reset 標頭，讓你在達到上限之前就能放慢速度。

進行批次作業時，請限制同時進行的請求數量，並以短暫的間隔重試，而不是緊密地連續重試。如果之後還需要同一張圖片，請把結果儲存下來重複使用。由快取提供的簽署網址不會計入上限。

如果要提高某個金鑰的上限，請寫信給 an@bannerify.co。