Rate Limits
Rate limits는 사용자에게 API 서비스에 접근할 수 있는 양을 제한하는 정책입니다. API의 오용과 남용을 방지하는 목적으로 활용하며, 모든 사용자가 동등하게 서비스를 활용할 수 있게 지원합니다.
제한된 사용량을 초과하게 되면 응답 오류(429)가 발생하게 되며, Rate limit Headers를 통하여 남은 사용량을 조회할 수 있습니다.
Rate Limit Headers
Rate limit 관련 정보는 응답의 HTTP Header에서 확인 가능합니다.
| Rate limit HTTP Headers | Description |
|---|---|
| x-{window}-rate-limit | 호출 가능한 최대 횟수
{window}는 second, minute, day 중 하나입니다. |
| x-{window}-rate-limit-remaining | 남아 있는 호출 가능한 횟수
{window}는 second, minute, day 중 하나입니다. |
| retry-after | 다시 요청할 수 있을 때까지의 대기 시간(초) |
| retry-after-ms | 다시 요청할 수 있을 때까지의 대기 시간(밀리초) |
※ retry-after, retry-after-ms는 헤더에 포함되지 않을 수 있습니다.
Examples
HTTP/1.1 429 Too Many Requests
...
retry-after: 1
retry-after-ms: 630
x-request-id: 01a1b489-0e13-76bd-85e1-f571524de67c
x-second-rate-limit: 1
x-second-rate-limit-remaining: 0
x-minute-rate-limit: 60
x-minute-rate-limit-remaining: 59
x-day-rate-limit: 86400
x-day-rate-limit-remaining: 86300x-request-id는 각 요청을 고유하게 식별하기 위한 값입니다. API 서비스에서 자동으로 생성하여 부여하게 됩니다.