HTTP 상태코드

HTTP 상태코드란 클라이언트가 보낸 요청의 처리 상태를 HTTP 응답을 통해 알려주기 위한 코드값이다.

---

1XX (Informational)

요청이 수신되어 처리중 (거의 사용 x)

2XX (Successful)

요청이 정상 처리 되었음을 뜻한다.

2XX대의 상태코드는 아래와 같이 여러가지가 있지만 , 주로 200/201을 사용한다

200 : OK

- 요청이 성공했음

 

201 : CREATED

- 요청이 성공해서 새로운 리소스가 생성되었음

- 응답 메시지의 Location을 통해 리소스를 식별한다.

 

202 : ACCEPTED

- 요청이 접수되었으나 처리가 완료되지 않음 (ex) 배치 돌리는 상황)

 

204 No Content

- 서버가 요청을 성공적으로 수행했지만, 응답 페이로드 본문에 보낼 데이터가 없음 (ex) 웹 문서 편집기에서 save 버튼 누를때)

3XX (Redirection)

요청을 완료하려면 추가 행동이 필요하다는 뜻으로, Location 헤더가 있으면 해당 헤더로 자동으로 이동시킨다.

주로 자원이 이동된 경우 웹 페이지를 이동시키기 위해 사용한다.

영구 리다이렉션, 일시 리다이렉션, 특수 리다이렉션 종류가 있고, 그에 따라 상태코드가 나뉜다.

📌 영구 리다이렉션

특정 리소스의 URI가 영구적으로 이동한 경우로, 새로운 URI로 처음부터 다시 요청해야 한다. (예) /members → /users)

다음과 같은 상태 코드들이 있다.

301 : Moved Permanently

- 리다이렉트 시 메서드가 GET으로 변하고, 본문이 제거될 수 있다 

 

308 : Permanent Redirect

- 301과 거의 동일한 기능이지만, 리다이렉트 시 요청 메서드와 본문을 유지한다는 차이가 있다.

- 해당 상태코드는 잘 안쓴다.

📌 일시 리다이렉션

리소스의 URI가 일시적인 변경 되어 리다이렉션 하는 경우 사용한다.

영구 리다이렉션 보다 자주 사용하고, PRG 패턴에서 사용된다.

(PRG 패턴 : POST 요청 후 GET 요청으로 변경해야 하는 경우에 사용하는 패턴, 예시로 주문완료 후 주문 내역 화면으로 이동하는 경우가 있다)

302 : Found

- 리다이렉트 시 메서드가 GET으로 변하고, 본문이 제거될 수 있다 (거의 다 변함)

 

307 : Temporary Redirect

- 302와 기능이 같지만, 리다이렉트 시 요청 메서드와 본문을 유지한다는 차이가 있다

 

303 : See Other

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

📌 특수 리다이렉션

서버가 요청을 처리하지 않고, 캐시를 사용하는 경우 쓰는 상태 코드

304 : Not Modified

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

- 해당 상태 코드를 받은 클라이언트는 로컬 PC에 저장된 캐시를 재사용해서 리다이렉트 한다

- Body를 포함하면 안된다

4XX (Client Error)

클라이언트의 요청에 잘못된 문법 등으로 서버가 요청을 수행할 수 없음을 뜻한다.

이 경우에는 서버에 같은 요청을 재시도 해도 동일한 오류가 발생한다.

400 : Bad Request

- 클라이언트가 요청 구문, 메시지 등의 오류로 잘못된 요청을 해서 서버가 처리할 수 없음을 뜻한다.

- 클라이언트는 요청 내용을 다시 검토하고 보내야함 (ex) 요청 파라미터가 잘못되거나 , API 스펙이 맞지 않을 때)

 

401 : Unauthorized

- 클라이언트가 해당 리소스에 대한 인증(Authentication)이 필요함을 뜻한다.

- 주로 로그인 안되어있는데 리소스에 접근하려 할 때 사용한다

- 응답 메시지 헤더에  www-authenticate 헤더와 함께 인증 방법 설명한다. 

 

403 : Foribidden

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

- 주로 인증 자격 증명은 있지만, 접근 권한이 불충분한 경우

 

404 : Not Found

- 요청 리소스를 찾을 수 없음을 뜻한다. 

- 주로 요청 리소스가 서버에 없거나, 클라이언트가 권한이 부족한 리소스에 접근할 때 해당 리소스를 숨기고 싶을 때 사용한다.

5XX (Server Error)

서버 내부에 오류가 발생해서 정상 처리를 하지 못했음을 의미하는 상태코드이다.

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

실무에서는 5XX 상태 코드가 발생했을 때 대부분 시스템 장애로 판단한다.

그렇기 때문에, 서버 단에서는 비즈니스 로직으로 인한 오류가 5XX 상태 코드를 리턴하지 않도록 잘 처리해야 한다.

500 : Internal Server Error

- 서버 내부 문제로 오류가 발생했음을 뜻함.  (대부분 서버 오류나면 이 500 에러인 경우가 많음)

 

503 : Service Unavailable

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

- HTTP 헤더에 Retry-After를 추가하여 얼마뒤에 복구되는지 보낼 수 있다.