HTTP Status Code
서버가 클라이언트의 요청에 대한 응답 상태를 나타내는 3자리 숫자.
| 클래스 | 코드 | 설명 | 주요 사용 케이스 | 관련 HTTP 메서드 |
|---|---|---|---|---|
| 정보 응답 | 100 | Continue | 대용량 파일 업로드 시 서버의 준비 상태 알림. 클라이언트가 전체 요청 전 서버의 수락 여부 확인 | POST, PUT |
| 101 | Switching Protocols | 웹소켓 연결 시작 시 프로토콜 전환 요청에 대한 응답 | GET | |
| 성공 응답 | 200 | OK | GET: 리소스 성공적 조회. POST: 요청 성공 처리, 응답 본문에 결과 포함. PUT/PATCH: 리소스 업데이트 성공, 업데이트된 리소스 반환. DELETE: 삭제 성공, 추가 정보 제공 | GET, POST, PUT, PATCH, DELETE |
| 201 | Created | POST: 새 리소스 생성 성공. PUT: 특정 URI에 새 리소스 생성. 응답 헤더에 새 리소스의 URI 포함 | POST, PUT | |
| 202 | Accepted | 요청이 접수되었으나 처리는 완료되지 않음. 비동기 작업(대용량 데이터 처리, 백그라운드 작업 등)에 사용 | POST, PUT, DELETE, PATCH | |
| 204 | No Content | DELETE: 리소스 삭제 성공, 추가 정보 불필요. PUT/PATCH: 리소스 업데이트 성공, 반환할 내용 없음 | DELETE, PUT, PATCH | |
| 206 | Partial Content | GET: 클라이언트의 부분 요청 성공. 대용량 파일 다운로드나 미디어 스트리밍에 사용 | GET | |
| 리다이렉션 | 301 | Moved Permanently | 웹사이트 구조 변경으로 페이지 URL 영구 변경. 도메인 변경 시 이전 도메인에서 새 도메인으로 리다이렉트 | GET, POST |
| 302 | Found | 임시 리다이렉션 (예: 유지보수 중 임시 페이지). A/B 테스팅에서 다른 버전 페이지로 리다이렉트 | GET, POST | |
| 304 | Not Modified | 브라우저 캐시 유효성 확인. 조건부 GET 요청에 대해 리소스 미변경 표시 | GET | |
| 307 | Temporary Redirect | 302와 유사하나 HTTP 메서드 변경 없이 임시 리다이렉트 | GET, POST, PUT, DELETE | |
| 클라이언트 에러 | 400 | Bad Request | 잘못된 요청 구문 (예: 잘못된 JSON 형식). 필수 파라미터 누락 또는 유효하지 않은 값 전송 | 모든 메서드 |
| 401 | Unauthorized | 보호된 리소스에 인증 없이 접근. 유효하지 않거나 만료된 인증 정보 제공 | 모든 메서드 | |
| 403 | Forbidden | 인증된 사용자의 접근 권한 없는 리소스 요청. IP 기반 접근 제한 적용 | 모든 메서드 | |
| 404 | Not Found | 요청 URL에 해당 리소스 없음. 삭제된 페이지나 잘못된 URL 요청 | 모든 메서드 | |
| 405 | Method Not Allowed | 허용되지 않는 HTTP 메서드로 리소스 접근 시도 | 모든 메서드 | |
| 409 | Conflict | 동시성 문제로 리소스 상태 충돌. 중복 데이터 생성 시도 | PUT, POST, DELETE | |
| 422 | Unprocessable Entity | 요청 형식은 올바르나 의미적으로 처리 불가 (예: 유효성 검사 실패) | POST, PUT, PATCH | |
| 429 | Too Many Requests | 사용자의 요청 빈도 초과 (rate limiting). API 사용량 제한 초과 | 모든 메서드 | |
| 서버 에러 | 500 | Internal Server Error | 서버의 예기치 못한 오류. 처리되지 않은 예외 발생 | 모든 메서드 |
| 502 | Bad Gateway | 프록시/게이트웨이가 업스트림 서버로부터 잘못된 응답 수신. 로드 밸런서 뒤 서버 다운 | 모든 메서드 | |
| 503 | Service Unavailable | 서버의 일시적 요청 처리 불가 (유지보수, 과부하). 계획된 다운타임 알림 | 모든 메서드 | |
| 504 | Gateway Timeout | 게이트웨이/프록시의 업스트림 서버 응답 대기 시간 초과. 마이크로서비스 응답 시간 초과 | 모든 메서드 |