HTTP 429: Too Many Requests

적용 범위

이 문서는 HTTP 429 응답을 확인합니다. 서버가 적용한 제한 기준이나 재시도 정책은 서비스마다 다르므로 상태 코드만으로 판단하지 않습니다.

변경 없이 확인할 항목

1. 요청 URL, HTTP 메서드, HTTP 429 상태와 발생 시각을 기록합니다.
2. 응답에 Retry-After 헤더가 있는지와 값을 기록합니다.
3. 같은 사용자·네트워크·작업에서 반복되는 요청인지 확인 가능한 범위에서 기록합니다.

RFC 6585는 HTTP 429를 일정 기간에 너무 많은 요청을 보낸 상태로 정의하고, 응답에 Retry-After를 포함할 수 있다고 설명합니다. 제한 기준과 사용자 식별 방식은 이 상태 코드만으로 알 수 없습니다.

다음 문서

HTTP 상태 코드의 기본 의미는 HTTP 상태 코드에서 확인합니다.

관찰값 기록

문제가 발생한 URL 또는 화면, 표시 시각, 운영 환경과 최근 변경 사항을 먼저 기록합니다. 화면이나 로그에 오류 문구가 일부만 보이면 앞뒤 문장을 보존하고 비밀번호·토큰·쿠키·개인정보는 가립니다.

다음 항목을 실제 값과 함께 확인합니다.

1. 요청 URL, HTTP 메서드, HTTP 429 상태와 발생 시각을 기록합니다.
2. 응답에 Retry-After 헤더가 있는지와 값을 기록합니다.
3. 같은 사용자·네트워크·작업에서 반복되는 요청인지 확인 가능한 범위에서 기록합니다.

판정 기준

오류 문구가 일치해도 같은 원인이 확정되는 것은 아닙니다. 웹서버·런타임·운영체제·플랫폼과 최근 변경 사항을 비교하고, 기대한 관찰값이 나오지 않으면 다음 단계로 넘어가지 않습니다. 이 문서는 출처가 확인한 범위만 설명하며, 범위를 벗어난 원인과 조치는 단정하지 않습니다.

안전한 다음 확인

설정·권한·데이터를 변경하기 전에 백업과 되돌리기 방법을 기록합니다. 운영 환경의 방화벽 전체 해제, 인증서 검증 우회, 데이터 삭제, 비밀값 공개를 기본 조치로 사용하지 않습니다. 확인 결과가 문서의 조건과 다르면 관련 Platform·Component 문서와 공식 출처를 먼저 확인합니다.