웹 프로그래밍 - RESTful한 HTTP 요청 메서드와 HTTP 응답 상태 코드

HTTP 요청 메서드와 HTTP 응답 코드를 잘 알고 사용한다면 우리는 보다 쉽게 RESTful 하게 HTTP 프로토콜을 사용할 수 있습니다. 뿐만 아니라 HTTP 프로토콜은 REST(Representational State Transfer) 아키텍처 위에서 더 큰 빛을 발하는 통신 규약입니다. 하지만 생각보다 API를 REST 하게 설계하고 사용하는 것은 말처럼 그리 간단치 않습니다.

HTTP 요청 메서드

먼저 알아볼 부분은 HTTP 요청 메서드입니다. HTTP 요청 메서드는 요청(Request)을 통해 기대하는 행동을 말합니다. 예를 들어 서버에서 처리를 하지 않는다고 해도 https://7942yongdae.tistory.com/이라는 URL에 GET 요청(Request)하면 조회를 하고 싶다는 의미이고, POST를 요청한다면 무언가 글을 등록하고 싶다는 의미가 됩니다.

 

 tip. 하나의 URL(혹은 URI)을 통해 GET, HEAD, POST, PUT, PATCH, DELETE과 같은 요청을 처리할 수 있도록 한 이유는 하나의 URL을 가지고 여러 가지 일을 할 수 있도록 정의하기 위함입니다. 예를 들어 글 추가, 수정, 삭제를 위해 각 각의 URL 3개를 만드는 것보다 1개의 URL을 가지고 상황(요청 메서드)에 따라 처리하는 게 효율적일 수 있습니다.

유형	개요
GET	조회
HEAD	조회 - 응답 바디 제외
POST	생성 || 추가
PUT	전체 갱신 || 추가 (자원이 없는 경우)
PATCH	일부 갱신
DELETE	삭제

 참고 - https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html

HTTP 응답 상태 코드

HTTP 프로토콜을 기준으로 클라이언트와 서버 간에 통신이 이루어지면, 요청(Request)을 한 후 결과로 응답(Response)을 돌려받습니다. 이때 응답은 HTTP 상태 코드를 포함하고 있습니다. HTTP 응답 상태 코드를 공부한다면, 응답 결과의 상태 코드만으로 성공, 실패 여부를 판별할 수 있고 한발 더 나아가 API를 설계할 때도 도움이 됩니다. 정의된 HTTP 상태 코드는 다음과 같습니다.

통신 상황에 대한 정보를 알려주는 1xx - HTTP 응답 코드

코드	개요	설명
100	Continue	클라이언트가 보낸 요청에 문제가 없으니, 다음 요청을 이어서 보내도 문제가 없습니다.
101	Switching Protocols	클라이언트 요청에 정의된 upgrade 헤더에 따라 서버가 프로토콜을 바꿉니다.

요청의 성공을 정의하는 2xx - HTTP 응답 코드

코드	개요	설명
200	OK	요청을 성공적으로 처리했습니다.
201	Created	요청을 성공적으로 처리했으며, 그 결과로 새로운 Resource를 생성했습니다.
202	Accepted	요청을 접수만 완료하였습니다. 주로 비동기적으로 처리하는 작업을 위해 만들어졌습니다.
203	Non-Authoritative Information	요청은 성공했지만, Header의 메타 데이터가 원본과 동일하지 않습니다. 주로 Proxy에 의해 Header 값이 변환됩니다.
204	No Content	요청을 처리했지만, 반환 하는 응답 바디가 없습니다.
205	Reset Content	요청 처리 후, 클라이언트에게 요청을 보낸 화면을 새로고침하라고 알려줍니다.
206	Partial Content	범위(Range) 헤더를 이용 할 때 사용되는 성공 상태 코드입니다. 클라이언트에서 다수의 스트림을 이용해 데이터를 받을 때 사용됩니다.

리다이렉트(Redirect)를 정의한 3xx - HTTP 응답 코드

코드	개요	설명
300	Multiple Choice	하나 이상의 응답이 가능하며, 다수의 결과 중 하나를 반드시 선택해야 합니다.
301	Moved Permanently	요청한 Resource의 위치가 변경되었습니다. 변경된 위치값은 포함 될 수 있습니다.
302	Found	요청한 Resource의 위치가 임시로 변경되었습니다.
303	See Other	요청한 Resource는 다른 URL을 통해 얻을 수 있습니다.
304	Not Modified	캐시를 목적으로 사용되며, 요청한 Resource가 수정되지 않았음을 알려줍니다.
307	Temporary Redirect	요청한 Resource의 위치가 임시로 변경되었습니다. 302와 동일한 의미를 가지며, HTTP 메소드를 변경하면 안된다는 점이 다릅니다.
308	Permanent Redirect	요청한 Resource의 위치가 변경되었습니다. 301과 동일한 의미를 가지며, HTTP 메소드를 변경하면 안된다는 점이 다릅니다.

잘못된 요청임을 알려주는 4xx - HTTP 응답 코드

코드	개요	설명
400	Bad Request	전달 된 데이터의 잘못된 문법으로 서버가 요청을 이해할 수 없습니다.
401	Unauthorized	HTTP 표준은 미인증(Unauthorized)를 나타내지만, 이 응답은 비인증(unauthenticated)를 의미합니다.
402	Pyament Required	전자 결제 시스템에 사용하기 위해 예약된 상태 코드로, 현재는 사용되고 있지 않습니다.
403	Forbidden	Resource에 접근한 권리를 가지고 있지 않습니다. 401과 다른점은 클라이언트를 알고 있다는 것입니다.
404	Not Found	Resource가 존재하지 않습니다.
405	Method Not Allowd	요청한 Method를 허용하지 않습니다.
406	Not Acceptable	클라이언트가 정한 규격에 따른 콘텐츠가 존재하지 않습니다.
407	Proxy Authentication Required	인증되지 않은 요청을 받았습니다. 프록시를 통해 완료된 인증이 필요합니다.
408	Request Timeout	클라이언트가 서버가 지정한 시간 내에 요청을 보내지 않았습니다.
409	Conflict	Resource의 현재 상태 때문에 요청을 완수할 수 없습니다. 예: 일괄 처리 작업 요청 처리 중에 다시 요청이 발생한 경우
410	Gone	Resource가 삭제되어, 더 이상 존재하지 않습니다.
411	Length Required	헤더에 Content-Length 필드가 정의되어 있지 않습니다.
412	Precondition Failed	클라이언트의 헤더에 있는 전제 조건이 서버의 전제 조건에 적합하지 않습니다.
413	Payload Too Large	클라이언트가 요청한 Entity는 서버에서 정의한 크기보다 큽니다.
414	URI Too Long	클라이언트가 요청한 URI는 서버에서 처리가능한 길이보다 깁니다.
415	Unsupported Media Type	요청한 미디어 포맷은 서버에서 지원하지 않습니다.

서버 처리 과정에서 문제가 발생했음을 알려주는 5xx - HTTP 응답 코드

코드	개요	설명
500	Internal Server Error	서버에서 예상하지 못한 문제가 발생했습니다.
501	Not Implemented	요청한 기능을 지원하지 않습니다.
502	Bad Gateway	게이트웨이로 작업하는 동안 잘못된 응답을 수신했습니다.
503	Service Unavailable	일시적으로 서버를 사용할 수 없습니다.
504	Gateway Timeout	서버가 게이트웨이 역할을 하고 있으며 적시에 응답을 받을 수 없습니다.
505	HTTP Version Not Supported	요청 메시지의 HTTP 프로토콜 버전을 서버가 지원하지 않습니다.

 참고 - https://datatracker.ietf.org/doc/html/rfc2616#section-10, https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html