> 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/ko/developers/api/rate-limiting.md).

# 호출 제한

> 박스히어로 API는 팀 단위로 호출 횟수를 제한하며, 제한에 걸리면 잠시 후 다시 요청해야 합니다.

모든 사용자가 안정적으로 서비스를 이용할 수 있도록 박스히어로 API는 팀이 보낼 수 있는 요청 수를 제한합니다.

## 팀 단위 제한

같은 팀에 속한 모든 API 토큰은 하나의 제한을 함께 사용합니다. 한 팀에서 토큰을 여러 개 발급해도 제한은 늘어나지 않습니다.

## 제한에 걸렸을 때

API는 `429`와 함께 `type`이 `/errors/too-many-requests`인 [오류 응답](https://www.boxhero.io/docs/ko/developers/api/errors)을 반환합니다. 언제 다시 요청할 수 있는지는 응답 헤더로 알려 줍니다.

| 헤더 | 설명 |
| --- | --- |
| `Retry-After` | 다시 요청하기 전에 기다려야 하는 시간(초) |
| `RateLimit`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` | 현재 제한, 남은 요청 수, 제한이 초기화되는 시점 |

`Retry-After`에 안내된 시간만큼 기다린 후 다시 요청해 주세요. 요청을 연달아 많이 보내야 한다면 한꺼번에 보내지 말고 간격을 두고 나누어 보내 주세요.

> **Note**
>
> 제한 값은 바뀔 수 있습니다. 클라이언트에 요청 속도를 고정해 두지 말고 응답 헤더를 확인해 주세요.