HTTP - HTTP 상태코드

1. HTTP 상태코드란?

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

 

2. HTTP 상태코드의 필요성 및 활용

• 성공코드 2xx : 요청 정상처리. 클라이언트에게 API 요청이 성공적으로 처리되었음을 알린다. 데이터를 적절히 표시하거나, 사용자에게 성공 메시지를 보여줄 수 있다. 

• 리다이렉션 코드 3xx : 요청을 완료하려면 추가행동이 필요. 클라이언트에게 다른 페이지로 리다이렉션하도록 지시한다. 
• 클라이언트 오류 코드 4xx : 클라이언트 오류. 요청을 수정하여 다시 시도하도록 요청한다. 예를 들어, 폼 검증 실패, 필수 정보 누락 시 클라이언트에게 통지할 수 있다.

• 서버 오류 코드 5xx : 서버 오류. 서버 문제가 있음을 클라이언트에게 알리고 문제가 해결될 때까지 기다리거나, 필요한 경우 지원팀에게 문의하도록 할 수 있다.

 

3. 2xx (Successful) : 클라이언트의 요청을 성공적으로 처리

1) 2xx 코드 종류

▪️ 200 OK

- GET으로 리소스 조회 성공했을 때

 

▪️  201 Created

- POST로 새로운 리소스 생성됐을 때

 

▪️  202 Accepted

- 요청이 접수 되었으나 처리 완료되지 않았을 때. (ex. 배치 처리)

 

▪️  204 No Content

- 요청 성공적으로 처리했으나 전송할 콘텐츠가 없을 때. (ex. 웹 문서 편집기에서 save버튼 눌렀을 때. DELETE로 리소스 삭제했을 때)

 

4. 3xx : 리다이렉션

1) 리다이렉션이란? 

웹브라우저는 3xx 응답 결과에 Location 헤더가 있으면, Location 위치로 자동 이동한다.

 

2) 리다이렉션의 종류 3가지

- 영구 리다이렉션 : 특정 리소스의 URI가 영구적으로 이동

- 일시 리다이렉션 : 일시적인 변경 (ex. 주문 완료 후 주문 내역 화면으로 이동)

- 특수 리다이렉션 : 결과 대신 캐시를 사용

 

3) 3xx 코드 종류

▪️  301 Moved Permanently 

- 영구적 리다이렉션 , 리다이렉트시 요청 메서드가 GET으로 변한다. 본문이 제거 될 수도 있음.

▪️  308 Permanent Redirect

- 영구적 리다이렉션 ,  리다이렉트시 요청 메서드와 본문 유지(처음 POST를 보내면 리다이렉트도 POST 유지)

(실무에서는 308 거의 안씀)

 

▪️  302 Found 

- 일시적 리다이렉션, 리다이렉트시 요청 메서드가 GET으로 변한다. 일시적으로 다른 위치로 이동한다.

- 명확하지 않지만, 실무에서 여전히 사용많이 함.

▪️  303 See Other

- 302와 기능 같음. 리다이렉트시 요청 메서드가 GET으로 변경.

▪️  307 Temporary Redirect

- 302와 기능은 같음. 리다이렉트시 요청 메서드와 본문 유지.(요청 메서드 변경X)

 

▪️  304 Not Modified

- 캐시를 목적으로 사용

- 클라이언트에게 리소스가 수정되지 않았음을 알려준다.

클라이언트는 로컬PC에 저장된 캐시를 재사용한다. (캐시로 리다이렉트 한다.)

- 304 응답은 응답에 메시지 바디를 포함하면 안된다. 

- 조건부 GET 요청시 사용

 

▪️  PRG : Post/Redirect/Get

- POST 요청 후 웹 브라우저의 새로고침으로 인한 중복 주문을 방지하기 위해 사용되는 패턴이다.

- 사용자가 데이터를 POST로 전송한 후, 서버는 해당 데이터를 처리하고 결과 페이지로 리다이렉트를 통해 GET 요청을 유도합니다.

▶️ 새로고침을 해도 중복 데이터 전송 없이 결과 화면만 다시 로드됩니다.

 

 

5) 4xx 코드 종류 : 오류의 원인이 클라이언트에 있음

클라이언트가 잘못된 요청을 해서 서버가 요청을 처리할 수 없음

▪️ 401 Unauthorized 

- 클라이언트가 해당 리소스에 대한 인증이 필요함

- 401 오류 발생 시 응답에 인증 방법을 설명

 

▪️ 403 Forbidden

- 서버가 요청을 이해했지만 승인을 거부함

- 접근 권한이 불충분한 경우.

ex) 관리자 등급이 아닌 사용자가 로그인을 했지만, 관리자 등급의 리소스에 접근하는 경우

 

▪️ 404 Not Found

- 요청 리소스가 서버에 없음 

- 클라이언트가 권한이 부족한 리소스에 접근할 때, 해당 리소스를 숨기고 싶을 때

 

6) 5xx 코드 종류 - 서버 문제로 오류 발생

서버에 문제가 있기 때문에 재시도 하면 성공할 수도 있음.

▪️  500 Internal Server Error

- 서버 내부 문제로 오류 발생

▪️ 503 Service Unavailable

- 서버가 일시적 과부하 또는 예정된 작업으로 잠시 요청 처리할 수 없음.