호출 제한
박스히어로 API는 팀 단위로 호출 횟수를 제한하며, 제한에 걸리면 잠시 후 다시 요청해야 합니다.
모든 사용자가 안정적으로 서비스를 이용할 수 있도록 박스히어로 API는 팀이 보낼 수 있는 요청 수를 제한합니다.
팀 단위 제한
섹션 제목: “팀 단위 제한”같은 팀에 속한 모든 API 토큰은 하나의 제한을 함께 사용합니다. 한 팀에서 토큰을 여러 개 발급해도 제한은 늘어나지 않습니다.
제한에 걸렸을 때
섹션 제목: “제한에 걸렸을 때”API는 429와 함께 type이 /errors/too-many-requests인 오류 응답을 반환합니다. 언제 다시 요청할 수 있는지는 응답 헤더로 알려 줍니다.
| 헤더 | 설명 |
|---|---|
Retry-After | 다시 요청하기 전에 기다려야 하는 시간(초) |
RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset | 현재 제한, 남은 요청 수, 제한이 초기화되는 시점 |
Retry-After에 안내된 시간만큼 기다린 후 다시 요청해 주세요. 요청을 연달아 많이 보내야 한다면 한꺼번에 보내지 말고 간격을 두고 나누어 보내 주세요.