토큰 버킷: API 요청을 제한하는 방법

버킷에는 토큰이 일정 속도로 채워지고, 요청 하나가 올 때마다 토큰 하나를 꺼내 씁니다. 토큰이 없으면 요청은 거절됩니다.

① 토큰 공급 (일정 속도)

② 버킷 (최대 용량까지만 저장)

③ 들어오는 요청

버튼을 눌러 요청을 보내 보세요.
✓ 허용 0 ✕ 거절(429) 0
  1. 채움: 1초마다 정해진 개수의 토큰이 들어옵니다. 버킷이 가득 차면 넘치는 토큰은 버려집니다.
  2. 소비: 요청 1건 = 토큰 1개. 토큰이 있으면 즉시 처리합니다.
  3. 거절: 토큰이 0개면 요청을 거절합니다(HTTP 429 Too Many Requests).

직접 해 보기 — ① 가만히 두어 버킷을 가득 채운 뒤 「한꺼번에 10개」를 눌러 보세요. 모아 둔 토큰만큼은 한 번에(버스트) 통과합니다. ② 자동 요청 속도를 채우는 속도보다 높게 두면, 처음엔 버킷이 버티다 비는 순간부터 평균 처리량이 채우는 속도로 제한됩니다.