HTTP 상태코드

1. 상태코드

클라이언트가 보낸 요청 처리 상태를 응답에서 알려주는 기능

 

2. 대표적인 상태코드

 

1) 1xx(Informational)

- 요청이 수신되어 처리중

- 거의 사용하지 않으므로 생략

 

2) 2xx(Successful)

- 요청 정상 처리

200	OK	요청 성공
201	Created	- 요청 성공해서 새로운 리소스가 생성됨 - 생성된 리소스는 응답의 Loacation 헤더 필드로 식별
202	Accepted	- 요청이 접수되었으나 처리가 완료되지 않음 - 배치 처리 같은 곳에서 사용(요청 후 1시간 뒤 배치 프로세스가 요청을 처리함)
204	No Content	- 서버가 요청을 성공적으로 수행했지만, 응답 페이로드 본문에 보낼 데이터가 없음 - 결과 내용이 없어도 204(2xx)만으로 성공을 인식할 수 있음 예) 웹 문서 편집기에서 save 버튼 결과로 아무 내용이 없어도 되는 경우, save 버튼을 눌러도 같은 화면을 유지해야하는 경우

 

3) 3xx(Redirection)

-  요청을 완료하기 위해 유저 에이전트(클라이언트)의 추가 행동(조치) 필요

-  리다이렉션: 웹 브라우저는 3xx 응답의 결과에 Location 헤더가 있으면 Location 위치로 자동 이동

- 리다이렉션 종류

영구 리다이렉션	- 특정 리소스의 URI가 영구적으로 이동 - 원래 URL를 사용하지 않음, 검색 엔진 등에서도 변경 인지 가능
일시 리다이렉션	- 리소스의 URI가 일시적으로 변경 - 따라서 검색 엔진 등에서 URL을 변경하면 안됨 - PRG(Post Redirect Get)   POST로 주문 후 새로고침 했을 경우 중복 주문 방지   POST로 주문 후 주문 결과 화면을 GET 메서드로 리다이렉트
특수 리다이렉션	결과 대신 캐시를 사용

 

- 자주 사용하는 300번대 상태코드

300	Multiple Choices
301	Moved Permanently	- 영구 리다이렉션 - 리다이렉트시 요청 메서드가 GET으로 변하고, 본문이 제거될 수 있음
302	Found	- 일시적인 리다이렉션 - 리다이렉트시 요청 메서드가 GET으로 변하고 본문이 제거될 수 있음
303	See Other	- 일시적인 리다이렉션 - 302와 기능은 같음 - 리다이렉트시 요청 메서드가 GET으로 변경
304	Not Modified	- 캐시를 목적으로 사용 - 클라이언트에게 리소스가 수정되지 않았음을 알려줌, 따라서 클라이언트는 로컬 PC에 저장된 캐시를 재사용(캐시로 리다이렉트 - 304 응답은 응답에 메시지 바디를 포함하면 안됨(로컬 캐시를 사용해야 하므로) - 조건부 GET, HEAD 요청 시 사용
307	Temporary Redirect	- 일시적인 리다이렉션 - 302와 기능은 같음  - 리다이렉트시 요청 메서드와 본문 유지(요청 메서드를 변경하면 안됨)
308	Permanent Redirect	- 영구 리다이렉션 - 301과 기능은 같음 - 리다이렉트시 요청 메서드와 본문 유지(처음 POST를 보내면 리다이렉트도 POST)

 

4) 4xx(Client Error)

- 클라이언트 오류, 잘못된 문법 등으로 서버가 요청을 수행할 수 없음

- 클라이언트가 이미 잘못된 요청, 데이터를 보내고 있기 때문에 재시도가 당연히 실패(500대 오류는 재시도가 성공 할 수도 있음)

400	Bad Request	클라이언트가 잘못된 요청을 해서 서버가 요청을 처리할 수 없음
401	Unauthorized	- 클라이언트가 해당 리소스에 대한 인증이 필요함 - 인증(Authentication)되지 않음 - 401 오류 발생시 응답에 WWW-Authenticate 헤더와 함께 인증 방법을 설명
403	Forbidden	- 서버가 요청을 이해했지만 승인을 거부함 - 주로 인증 자격 증명은 있지만 접근 권한이 불충분한 경우
404	Not Found	- 요청 리소스를 찾을 수 없음 - 또는 클라이언트가 권한이 불족한 리소스에 접근할 때 해당 리소스를 숨기고 싶을 때

 

5) 5xx(Server Error)

- 서버 오류, 서버가 정상 요청을 처리하지 못함

- 서버에 문제가 있기 때문에 재시도하면 성공할 수도 있음(복구가 되거나 등)

- 비즈니스 로직상의 에러인 경우 500에러 사용하지 말기!! 

500	Internal Server Error	- 서버 문제로 오류 발생
503	Service Unavailable	- 서버가 일시적인 과부하 또는 예정된 작업으로 잠시 요청을 처리할 수 없음 - Retry-After 헤더 필드로 얼마뒤에 복구되는지 보낼 수도 있음