5. HTTP 상태 코드
1. HTTP 상태코드
상태코드란 클라이언트가 보낸 요청의 처리가 제대로 잘 이루어졌는지 문제가 생겼는지 응답에서 알려주는 기능
- 1xx (Informational) : 요청이 수신되어 처리중
- 2xx (Successful) : 요청 정상 처리
- 3xx (Redirection) : 요청을 완료하려면 추가 행동이 필요
- 4xx (Client Error) : 클라이언트 오류, 잘못된 문법등으로 서버가 요청을 수행할 수 없음
- 5xx (Server Error) : 서버 오류, 서버가 정상 요청을 처리하지 못함
클라이언트가 인식할 수 없는 상태코드를 서버가 반환하게되면 클라이언트는 상위 상태코드로 해석해서 처리한다
추후 다른 상태코드가 추가되어도 클라이언트를 변경하지 않아도 된다.
예를 들면 상태코드가 299란식으로 오면 클라이언트는 이를 2xx(Successful)로 바꾸어 처리한다)
2. 2xx - 성공
- 200 OK : 클라이언트의 요청을 성공적으로 처리
- 201 Created : 서버에서 클라이언트 요청에대한 리소스를 생성.
- 202 Accepted : 요청이 접수가 되었으나 처리가 완료되지 않음
- 204 No Content : 서버가 요청을 성공적으로 수행했지만, 응답 페이로드 본문에 보낼 데이터가 없음
3. 3xx - 리다이렉션1
웹 브라우저는 3xx 응답의 결과에 Location 헤더가 있으면, Location 위치로 자동 이동(리다이렉트)
- 영구 리다이렉션 - 특정 리소스의 URI가 영구적으로 이동 301, 308
- 일시 리다이렉션 - 일시적인 변경 302, 307, 303
- 특수 리다이렉션 - 결과 대신 캐시를 사용
300 Multiple Choices : 잘 안씀
301 Moved Permanently : 리다이렉트시 요청 메서드가 GET으로 변하고, 본문이 제거될 수 있음
302 Found : 리다이렉트 요청 메서드가 GET으로 변하고, 본문이 제거될 수 있음
303 See Other : 302와 기능은 같음, 리다이렉트시 요청 메서드가 GET으로 변경
304 Not Modified : 캐시를 목적으로 사용, 클라이언트에 리소스가 수정되지 않았음을 알려준다.
클라이언트는 로컬PC에 저장된 캐시를 재사용한다. (캐시로 리다이렉트)
307 Temporary Redirect : 기능은 302와 같음, 리다이렉트시 요청 메서드와 본문 유지 (요청 메서드를 변경하면 안됨)
308 Permanent Redirect : 기능은 301과 같음. 리다이렉트 요청 메서드와 본문 유지
PRG : Post/Redirect/Get 일시적 리다이렉션
POST 요청 후에 웹 브라우저를 새로고침(다시 요청)하면 POST요청이 중복 될 수 있다.
예시) 결제하기 창에서 새로고침하면 결제가 한번 더됨, 게시글 작성하기 창에서 새로고침하면 게시글이 한번 더 작성됨
POST로 주문후에 주문 결과 화면을 GET메서드로 리다이렉트하면 새로고침을 하여도 결과화면이 GET으로 조회되기
때문에 중복 POST요청이 가지 않음
4. 4xx -클라이언트 오류
오류의 원인이 클라이언트에 있다는 뜻
- 클라이언트가 이미 잘못된 요청, 데이터를 보내고 있기 떄문에, 똑같은 재시도를 해도 실패함
- 클라이언트는 요청 내용을 다시 검토하고 보내야함
- 예) 요청 파라미터가 잘못되거나, API스펙이 맞지 않을 때
401 Unauthorized : 클라이언트가 해당 리소스에 대한 인증이 필요함
인증이 되지 않음 (인증 Authntication : 본인이 누구인지 확인) (인가 Authorization : 권한 확인)
403 Forbidden : 서버가 요청을 이해했지만 승인을 거부함
주로 인증 자격 증명은 있지만, 접근 권한이 불충분한 경우
404 Not Found : 요청 리소스를 찾을 수 없음
또는 클라이언트가 권한이 부족한 리소스에 접근할 때 해당 리소스를 숨기고 싶을 때
5. 5xx - 서버 오류
오류의 원인이 서버에 있음. 서버에 문제가 있기 때문에 재시도하면 성공할 수도 있음 (복구가 되거나 등등)
500 Internal Server Error : 서버 내부 문제로 오류 발생, 애매하면 500오류
503 Service Unavailable : 서비스 이용 불가
서버가 일시적인 과부하 또는 예정된 작업으로 잠시 요청을 처리할 수 없음
Retry-After 헤더 필드로 얼마뒤에 복구되는지 보낼 수도 있음