HTTP 상태 코드 참도표
NewHTTP 1xx, 2xx, 3xx, 4xx, 5xx 상태 코드 설명 및 사용 가이드.
전체 28개 중 28개 상태 코드 표시 중
Continue
서버가 요청 헤더를 수신하였으며 클라이언트는 본문(Body)을 계속 전송해야 합니다.
주요 활용 사례: 대용량 파일 업로드 시 사전 검증
Switching Protocols
클라이언트의 요청에 따라 서버가 다른 프로토콜로 전환 중입니다.
주요 활용 사례: HTTP에서 WebSocket으로 프로토콜 업그레이드
Processing
서버가 요청을 수신하여 작업 수행 중입니다.
주요 활용 사례: 복잡한 WebDAV 처리 작업
Early Hints
최종 응답 전 리소스 프리로드 힌트를 클라이언트에 미리 반환합니다.
주요 활용 사례: CSS/JS 리소스 사전 로딩 힌트
OK
요청이 성공적으로 처리되었습니다.
주요 활용 사례: 일반적인 성공 응답 (GET, POST 등)
Created
요청이 성공하여 새로운 리소스가 생성되었습니다.
주요 활용 사례: POST 요청으로 새 회원/게시글 생성 성공 시
Accepted
요청이 접수되었으나 아직 처리가 완료되지 않았습니다.
주요 활용 사례: 비동기 백그라운드 작업 큐 배치
No Content
요청이 성공했으나 반환할 본문 데이터가 없습니다.
주요 활용 사례: DELETE 성공 후 응답 본문이 없을 때
Partial Content
서버가 리소스의 일부 분량만 전달하고 있습니다.
주요 활용 사례: 대용량 파일 부분 분할 다운로드 및 비디오 스트리밍
Moved Permanently
요청한 리소스가 새로운 URL로 영구히 이동되었습니다.
주요 활용 사례: 도메인 변경 및 HTTP -> HTTPS 영구 리다이렉트
Found
요청한 리소스가 임시로 다른 URL로 이동되었습니다.
주요 활용 사례: 로그인 후 이동 페이지 등 임시 리다이렉트
Not Modified
캐시된 버전이 여전히 유효하므로 재전송하지 않습니다.
주요 활용 사례: 브라우저 ETag/If-None-Match 캐시 활용
Temporary Redirect
요청 메소드(POST 등)를 변경하지 않는 임시 리다이렉트.
주요 활용 사례: POST 양식 데이터 양식을 유지한 채 폼 제출 이동
Permanent Redirect
요청 메소드를 변경하지 않는 영구 리다이렉트.
주요 활용 사례: 301과 동일하지만 POST 메소드를 유지함
Bad Request
잘못된 요청 구문이나 유효하지 않은 인자입니다.
주요 활용 사례: JSON 파싱 에러, 필수 파라미터 누락
Unauthorized
인증 자격 증명이 필요하거나 인증에 실패했습니다.
주요 활용 사례: JWT 토큰 만료 또는 인증 헤더 누락
Forbidden
서버가 요청을 이해했지만 권한이 부족하여 거부되었습니다.
주요 활용 사례: 일반 사용자의 관리자 전용 페이지 접근 시도
Not Found
요청한 URL에 해당하는 리소스를 찾을 수 없습니다.
주요 활용 사례: 존재하지 않는 경로 또는 삭제된 데이터 접근
Method Not Allowed
해당 엔드포인트에서 지원하지 않는 HTTP 메소드입니다.
주요 활용 사례: POST 전용 API 엔드포인트에 GET 요청 시
Request Timeout
서버가 요청을 기다리다 전송 시간이 초과되었습니다.
주요 활용 사례: 네트워크 상태 지연으로 인한 타임아웃
Conflict
현재 서버 리소스 상태와 충돌이 발생했습니다.
주요 활용 사례: 중복 아이디 가입 신청, 동시 수정 충돌
Gone
요청한 리소스가 영구적으로 삭제되었습니다.
주요 활용 사례: 영구 삭제된 API 엔드포인트 및 데이터
Too Many Requests
단위 시간당 허용된 요청 횟수(Rate Limit)를 초과했습니다.
주요 활용 사례: API 트래픽 제한 차단
Unavailable For Legal Reasons
법적 이유로 인해 제공이 차단된 콘텐츠입니다.
주요 활용 사례: 저작권 또는 법적 검열로 인한 차단
Internal Server Error
서버 내부에서 예기치 않은 오류가 발생했습니다.
주요 활용 사례: 서버 애플리케이션의 처리되지 않은 예외(NullPointer 등)
Bad Gateway
게이트웨이가 상위 업스트림 서버로부터 잘못된 응답을 받았습니다.
주요 활용 사례: Nginx와 Node.js/Python 앱 서버 간 연결 실패
Service Unavailable
서버가 정기 점검 중이거나 과부하 상태입니다.
주요 활용 사례: 서버 유지보수 작업 또는 순간 트래픽 폭주
Gateway Timeout
게이트웨이가 상위 서버의 응답을 시간 내에 받지 못했습니다.
주요 활용 사례: 프록시 서버 뒤의 DB 쿼리 타임아웃 및 데이터 응답 지연
도구 소개
HTTP 상태 코드 참도표는 1xx(정보), 2xx(성공), 3xx(리다이렉션), 4xx(클라이언트 오류), 5xx(서버 오류) 상태 코드의 상세 설명과 REST API 가이드를 제공합니다.
사용 방법
- 1상태 코드 번호나 키워드로 원하는 코드를 검색합니다.
- 2각 코드를 클릭하여 의미와 적절한 사용 상황을 확인합니다.
자주 묻는 질문 (FAQ)
- 301과 302 리다이렉트의 차이는 무엇인가요?
- 301은 영구 이동(Permanent Move)을 의미하며 SEO 검색 링크 자산이 이관됩니다. 302는 임시 이동(Temporary Redirect)입니다.
- 401과 403의 차이는 무엇인가요?
- 401은 인증 필요(누구인지 모름), 403은 권한 없음(누구인지는 아나 해당 요청 권한이 없음)을 의미합니다.