HTTP 상태 코드

HTTP 상태 코드 

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

주로 1xx ~ 5xx 번대를 사용한다. 

 

만약 모르는 상태 코드가 나타나도 상위 상태 코드로 해석해서 처리하면 된다.

• 1xx: 요청이 수신되어 처리 중 
• 2xx: 요청 정상 처리 
• 3xx: 요청을 완료하려면 추가 행동이 필요
• 4xx: 클라이언트 오류 
• 5xx: 서버 오류 

1xx (Informational)

요청이 수신되어 처리 중 (거의 사용되지 않는다.)

 

2xx (Successful)

• 200: 요청 성공
• 201: 요청이 성공되어 새로운 리소스가 생성
• 202: 요청이 접수되었지만 처리가 완료되지 않았다. 
  • 즉 요청은 들어왔지만 처리는 나중에 배치 프로 스세가 처리함 
• 204: 요청은 성공했지만, 응답 페이로드 본문에 보낼 데이터가 없다.

주로 200과 201만 사용된다. 

주로 개발할 때 API요청을 보내 성공했을 때 200 Response를 본 것 같다.

 

3xx (Redirection)

요청을 완료하기 위해 유저 에이전트(웹 브라우저)의 추가 조치가 필요

300은 사용하지 않고 301~308이 중요하다. 

 

웹 브라우저는 3xx 응답의 결과에 Location 헤더가 있으면, Location 위치로 자동으로 이동한다. (이것을 리다이렉트)

리다이렉션 종류

• 영구 리다이렉션
• 일시 리다이렉션
• 특수 리다이렉션

이렇게 3가지 종류가 있다. 

영구 리다이렉션 (301, 308)

• 리소스 URI가 완전히 변경되었다.
• 원래의 URI를 사용할 수 없다. 검색 엔진에서 기존 URI로 들어오면 변경
• 301
  
  • 리다이렉트 요청이 GET으로 변하고, 본문이 제거될 수 있다. (될 수도 있고, 안 될 수도 있고)
• 308
  • 301과 기능이 똑같다
  • 하지만 요청 메서드와 본문을 유지한다. (POST를 보내면 리다이렉트도 POST 유지, PATCH를 보내면 리다이렉트도 PATCH 유지)
• 하지만 대체로 URI가 바뀌면 전송해야 하는 데이터도 달라져서 301을 사용한다고 한다.

일시적인 리다이렉션(302, 307, 303)

• 리소스 URI가 일시적으로 변경됨
• 검색 엔진에서 URI를 변경하면 안 된다.
• 302
  • 리다이렉트 요청 시 메서드가 GET으로 변하고 본문이 제거될 수도 있다. (될 수도 있고, 안 될 수도 있고)
• 307
  • 302와 기능이 같다.
  • 리다이렉트 요청 시 메서드와 본문 유지
• 303
  • 302와 기능이 같다. 
  • 리다이렉트 요청 시 메서드가 GET으로 변경

PRG ( Post/ Redirect/ Get )

그러면 일시적 리다이렉션은 언제 사용이 될까?

 

POST로 주문 요청을 하고 다시 웹 브라우저를 새로고침 한다면?

주문 요청을 다시 요청하여 중복 주문이 될 수 있다. 

 

이것을 해결하기 위해서 

• POST로 주문 후에 주문 결과 화면을 리다이렉트 
• 새로고침을 해도 리다이렉트 된 URI
• 중복 주문 대신 결과 화면만 GET으로 다시 요청

302, 307, 303 정리 

현재 많은 애플리케이션들이 302를 기본값으로 상용한다. 

자동 리다이렉션이 GET으로 변해도 되면 그냥 302를 사용해도 큰 문제는 없다. 

 

기타 리다이렉션

• 300
  
  • 사용되지 않는다. 
• 304
  • 캐시를 목적으로 사용한다.
  • 리소스가 수정되지 않았으므로 캐시 데이터를 사용하라고 지시 
  • 메시지 바디를 포함하면 안 된다.

 

4xx ( Client Error)

API 요청을 보내다 보면 가장 많이 만나는 상태 코드들 중 하나이다.

오류의 원인은 클라이언트에 있으므로 아무리 같은 요청을 보내도 해결되지 않는다.

• 400 Bad Request
  • 클라이언트가 잘못된 요청을 해서 서버가 요청을 처리할 수 없다.
  • 예) 요청 파라미터가 잘못, API 스펙이 맞지 않다.
• 401 Unauthorized
  • 인증(Authentication) 되지 않음
• 403 Forbidden
  • 서버가 요청을 이해했지만 승인을 거부함
  • 인증은 되었지만 접근 권한이 불충분하다.
• 404
  • 요청 리소스를 찾을 수 없다.
  • URL이 잘못되었거나, 권한이 부족한 리소스에 접할 때 해당 리소스를 숨기고 싶을 때 

5xx ( Server Error)

API 개발을 하다 보면 굉장히 많이 만나는 상태 코드들 중 하나이다. 

서버 내부의 문제로 같은 요청을 계속 보낸다면 서버 문제가 해결될 때 처리가 될 것이다.

• 500 Internal Server Error
  • 서버 문제로 오류 발생
  • 애매하면 500 에러를 발생
• 503 Service Unavailable
  • 서버가 일시적으로 과부하 또는 예정된 작업으로 잠시 요청을 처리할 수 없음
  • 하지만 주로 이런 현상은 예측 불가능이기 때문에 주로 500 에러를 보게 된다.