HTTP 상태코드

HTTP 상태코드 소개

---

• 추후에 새로운 상태코드가 나타나도 상위 상태코드로 해석해서 처리할 수 있다.

2xx - 성공

---

200 : OK

• 클라이언트에 대한 요청이 잘 처리된 경우

201 : created

• 클라이언트 요청이 성공해, 새로운 리소스가 생성된 경우
• 생성된 리소스는 응답의 Location 헤더 필드로 식별

202 : accepted

• 요청이 접수되었지만 처리가 완료되지 않은 경우
• 배치 처리 등에서 사용 → 현재 바로 처리를 하지 않는 경우

204 : No content

• 서버가 요청을 성공적으로 수행했지만, 응답 페이로드 본문에 보낼 데이터가 없는 경우
• 글 작성 후 save 버튼을 누른 경우 → save 버튼의 결과로 아무 내용이 없어도 된다.

3xx - 리다이렉션

---

• 요청을 완료하기 위해 유저 에이전트의 추가적인 조치가 필요한 경우

리다이렉션 이해

• 웹 브라우저는 3xx 응답 결과에 Location 헤더가 있으면, Location 위치로 자동 이동 : 리다이렉트
• 더 이상 사용하지 않는 웹페이지로 요청이 오면, 서버에서 301 코드를 사용해 새로운 페이지로 연결해줄 수 있다.

리다이렉션 종류

• 영구 리다이렉션 : 특정 리소스의 URI가 영구적으로 이동
  • ex) 페이지의 URI가 바뀐 경우
• 일시 리다이렉션 : 일시적으로 잠깐 이동
  • ex) 주문 완료 후 주문 내역 화면으로 이동
• 특수 리다이렉션 : 결과 대신 캐시를 사용

영구 리다이렉션 : 301, 308

• 리소스의 URI가 영구적으로 이동
• 검색 엔진에서 URI가 바뀐다.
• 301 Moved Permanently : 리다이렉트 시 요청 메서드가 GET으로 변경되고, 본문이 제거될 수 있음

• 308 Permanent Redirect : 리다이렉트 시 요청 메서드와 본문 유지

일시적 리다이렉션 : 302, 307, 303

• 리소스 URI가 일시적으로 변경
• 검색엔진에서 URI가 바뀌지 않는다.
• 302 Found : 리다이렉트시 요청 메서드가 GET으로 변하고, 본문이 제거될 수 있다.
• 307 Temporary Redirect : 리다이렉트 시 요청 메서드와 본문을 반드시 유지
• 303 See Other : 리다이렉트 시 요청 메서드가 GET으로 변경
  • 302가 명확하게 GET으로 변경되지 않으므로

일시적 리다이렉션 예시 - PRG(Post/Redirect/Get)

• 리다이렉션이 없는 상태에서, POST로 주문 후, 웹 브라우저를 새로고침하는 경우, POST 요청(주문)이 다시 들어가게 되는 문제가 발생

• 리다이렉션을 통해 POST가 완료되면, Redirect으로 주문 결과 화면을 GET으로 리다이렉트

기타 리다이렉션 : 300, 304

• 300 multiple choices : 사용 X
• 304 Not Modified : 클라이언트에게 리소스가 수정되지 않았음을 알려줌
  • 클라이언트는 로컬PC에 저장된 캐시를 재사용
  • 실제 데이터를 전달하지 않아도 되기 때문에 메세지 크기가 작아진다.

4xx - 클라이언트 오류, 5xx - 서버 오류

---

4xx

• 오류의 원인이 클라이언트에게 존재
• 클라이언트가 이미 잘못된 요청을 주기 때문에, 동일한 데이터를 보내면 항상 똑같이 실패
  • 요청을 수정해서 보내야 함

400 bad request

• 요청 구문, 메세지 등에 오류가 있는 경우 발생
  • 요청 파라미터가 잘못되거나, API 스펙이 맞지 않는 경우

401 Unauthorized

• 인증이 되지 않은 경우 발생
• WWW-authenticate 헤더와 함께 인증 방법을 설명해줘야 한다.
• 오류 메세지가 Unauthorized이지만, 실제 의미는 Unathentication

403 Forbidden

• 서버가 요청을 이해했지만, 승인을 거부한 경우 발생
• 주로 인증 자격 증명은 있지만, 접근 권한이 불충분한 경우

404 Not Found

• 요청 리소스가 서버에 없는 경우 발생
• 또는 클라이언트가 권한이 부족한 리소스에 접근할 떄, 해당 리소스를 숨기고 싶은 경우

5xx

• 서버 문제로 오류 발생
• 서버에 문제가 있기 때문에, 동일한 메세지에 대해 성공할 수 있다.

500 Internal Server Error

• 서버 내부 문제로 오류 발생
• 애매한 경우 모두 500 오류

503 Service Unavailable

• 서버가 일시적인 과부하 또는 예정된 작업으로 잠시 요청을 처리할 수 없는 경우
• Retry-After 헤더 필드로 얼마 뒤 복구되는지 볼 수 있다.