[TIL 7] - [CS] HTTP Method, 안전한 메서드와 멱등성 메서드, 상태 코드

찐새·2023년 5월 24일

TIL

목록 보기

6/20

HTTP Method

주어진 리소스에 대한 행동을 나타내는 방식이다. 특정 메서드를 활용한 요청 결과값을 서버가 미리 만들어두고, 클라이언트가 요청할 때마다 메서드에 맞는 결과를 반환한다. 이는 클라이언트와 서버 간의 약속으로, 협의가 잘 되어 있다면 굳이 메서드를 구분할 필요가 없다. 하지만 메서드를 적확하게 사용하면 API가 명확해지고 이해와 사용이 쉬워지기 때문에 표준을 지키는 편이 좋다.

REST API

API 방식 중 가장 많이 언급되는 방식인 REST API는 HTTP Method를 아름답게 사용한 API이다. 자세한 내용은 [TIL 5] - [CS] REST/RESTful API 참고.

Method 종류

대표적인 HTTP Method로는 GET, POST, PUT, DELETE가 있고, 추가로 PATCH가 있다.

Method	Description
`GET`	데이터를 가져온다
`POST`	데이터를 등록한다
`PUT`	데이터 전체를 바꾼다
`PATCH`	데이터 *일부분*을 바꾼다
`DELETE`	데이터를 삭제한다

이 외에 HEAD, OPTIONS, TRACE, CONNECT가 있는데, 뒤의 두 가지는 거의 사용하지는 않는다.

Method	Description
`HEAD`	`GET`과 비슷하나 응답 본문(body)가 없다. 라우터가 제대로 작동하는지 확인하는 데 사용할 수 있다.
`OPTIONS`	타 사이트로 요청을 보낼 때 사용한다. `preflight`와 연결된다
`TRACE`	프록시 서버를 거쳐 최종 서버로 가는 도중 어떤 헤더가 변경되었는지 추적한다. 거의 쓰지 않는다.

안전한 메서드와 멱등성 메서드

안전한 메서드는 아무리 요청을 보내도 서버에서 상태 변화를 일으키지 않는 메서드를 말한다. GET, HEAD, OPTIONS, TRACE 등이 있다. 예를 들어, GET 요청을 1만 번 보낸다한들 서버가 보내는 데이터의 상태는 늘 똑같다.

반면, POST의 경우, 자원을 추가하여 서버 변화를 일으키므로 안전한 메서드가 아니다.

멱등성 메서드는 같은 요청을 여러 번 보내도 서버에서는 한 번 바뀐 것과 다름 없음을 의미한다. 안전한 메서드(GET, HEAD, OPTIONS, TRACE)를 포함하여 PUT, DELETE가 있다.

put은 A를 B로 변환시키지만, 1만 번을 실행해도 B가 더는 변하지 않는다. DELETE 역시 1번 유저를 한 번 삭제하면 더는 다른 유저를 삭제하지 않는다. 때문에 이들은 멱등하다.

반면, POST는 1만 번 실행하면 새로운 자원이 1만 개 생성되므로 멱등하지 않고, 안전하지도 않다. PATCH는 사용 방식에 따라 다른데, 단순히 A.name를 gold에서 silver로 바꾼다면 멱등하겠지만, A.age를 계속 증가시키는 방식이라면 멱등하지 않다.

상태 코드

HTTP 요청 성공 여부를 알려주는 상태 코드는 5개의 그룹으로 나뉜다. 상태 코드는 브라우저가 다음에 해야 할 일을 추측할 수 있게 하므로, 최대한 지키는 편이 좋다. 중간중간 비어있는 코드 번호는 개발자가 임의로 지정해 재량으로 사용할 수 있다.

자주 사용하는 상태 코드 위주로 나열한다.

1xx - 정보

100 : 계속하라는 응답이며, 주로 스트리밍 같은 서비스에서 사용한다.
101 : 프로토콜을 바꿀 때 사용한다. HTTP에서 WS으로 변경하는 등.

2xx - 성공

200 : 데이터 요청이 성공했을 때 사용한다.
201 : 자원이 새로 생성되었을 때 사용한다.
204 : 요청이 성공했지만, 응답할 콘텐트가 없을 때 사용한다.
206 : 콘텐트의 일부분만 받았을 때 사용한다.

3xx - 리다이렉트

300 : 애매한 요청에 대한 응답이다. A와 B 중 어느쪽을 응답해야 할지 애매할 때 하나를 확실히 정하게끔 응답할 때 사용한다.
301 : 자원의 영구 이동을 의미한다. 도메인 변경 등에 사용한다.
302 : 자원의 임시적인 이동을 의미한다.
304 : 캐시를 목적으로 사용한다.
307 : 임시 이동을 의미하나, 302와 다르게 HTTP Method가 변경되어서는 안 된다. 즉, a.com에서 POST를 사용하여 b.com으로 리다이렉트했다면 b.com에서도 POST를 사용해야 한다.