跳到內容

速率限制

了解 BoxHero API 如何依團隊限制請求速率,以及如何退避並重試。

為了讓所有使用者都能穩定使用服務,BoxHero API 會限制每個團隊可傳送的請求數量。

屬於同一團隊的所有 API 權杖共用相同的限制。在同一團隊中發行更多權杖並不會提高限制。

API 會傳回 429 以及 type 為 /errors/too-many-requests 的錯誤封包。回應標頭會告訴您何時可以重試:

標頭說明
Retry-After重試前需等待的秒數
RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset目前的限制、剩餘的請求數,以及限制重設的時間

請等待 Retry-After 中指定的時間後再重試。若需要連續傳送大量請求,請分散傳送,而不要一次全部送出。