tool::http-status-detail

429 Too Many Requests

The user has sent too many requests in a given time (rate limiting).

상태 코드

429

이름

Too Many Requests

카테고리

4xx

상세 설명

HTTP 429 Too Many Requests는 클라이언트가 허용된 시간 내에 너무 많은 요청을 보냈음을 나타냅니다. API Rate Limiting의 표준 응답 코드입니다. Retry-After 헤더를 통해 언제 다시 요청할 수 있는지 알려줄 수 있습니다. DDoS 방어, API 남용 방지, 공정한 사용 보장을 위해 사용됩니다.

주요 원인

▸API 키의 분당/시간당 요청 한도를 초과한 경우
▸크롤러 또는 스크레이퍼가 짧은 시간에 과도한 요청을 보내는 경우
▸재시도 로직 없이 루프에서 API를 반복 호출하는 경우
▸여러 클라이언트가 동일 IP를 사용하여 한도를 공유하는 경우

해결 방법

1.Retry-After 헤더의 시간만큼 대기 후 재시도하세요
2.지수 백오프(Exponential Backoff) 전략을 구현하세요
3.API 키 플랜을 상위 등급으로 업그레이드하는 것을 고려하세요
4.요청을 캐싱하여 동일한 데이터를 반복 요청하지 않도록 하세요
5.여러 API 키를 사용하여 요청을 분산하세요 (서비스 약관 확인 필수)

응답 예시

HTTP/1.1 429 Too Many Requests
Retry-After: 60
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1711900800
Content-Type: application/json

{"error":"rate_limit_exceeded","message":"Too many requests. Please retry after 60 seconds."}

429 Too Many Requests

상세 설명

관련 HTTP 헤더

응답 예시

관련 상태 코드