> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/zh-tw/developers/api/rate-limiting.md).

# 速率限制

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

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

## 依團隊限制

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

## 達到限制時

API 會傳回 `429` 以及 `type` 為 `/errors/too-many-requests` 的[錯誤封包](https://www.boxhero.io/docs/zh-tw/developers/api/errors)。回應標頭會告訴您何時可以重試：

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

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

> **Note**
>
> 限制可能會變更。請從回應標頭讀取限制，而不要在用戶端中寫死速率。