PUT vs POST - MoonGyeongHyeon/Keyword_Study GitHub Wiki

REST API에서는 HTTP Method인 GET/PUT/POST/DELETE를 이용하여 서비스 제공자에게 서비스를 요청하는 방식이다.

<표 1. Method, CRUD, Idempotent>

위의 테이블에서도 볼 수 있듯이 POST는 생성, PUT은 업데이트를 할 수 있다. 그렇다면 언제 POST와 PUT을 사용해야 할까?

둘을 나누는 기준은 크게 두가지이다.

1. 멱등성
2. 리소스 결정권

Idempotent는 여러 번 수행해도 결과가 같은 경우를 의미한다. 예를 들면, a++는 호출 시마다 값이 증가하기 때문에 Idempotent하지 않다. 하지만 a=4와 같은 명령은 반복적으로 수행해도 값이 같이 때문에 Idempotent하다.

POST 연산의 경우에는 리소스를 추가하는 연산이기 때문에 Idempotent하지 않지만, PUT은 반복 수행해도 Idempotent 하다.

URI가 서버에 의해 결정되는지, 클라이언트에 의해 결정되는지에 따라 POST와 PUT으로 나뉜다.

POST의 경우, 클라이언트는 리소스가 실제 저장될 위치를 모르기 때문에 서버에서 처리하도록 하게 한다.

POST /articles HTTP/1.1 

<article>
    <title>blue stapler</title> 
    <price currency="eur">7.50</price> 
</article>
HTTP/1.1 201 Created Location: /articles/63636 

PUT을 사용하면 클라이언트가 이미 변경할 리소스의 위치를 알고 있기 때문에, 특정 업데이트 대상 리소스를 갱신할 수 있다.

PUT /article/1234 HTTP/1.1 

<article> 
    <title>red stapler</title> 
    <price currency="eur">12.50</price> 
</article>

멱등성을 갖지 않고 리소스를 서버가 결정해주면 POST, 멱등성을 가지고 있으면서 리소스를 클라이언트가 결정하면 PUT이다.

헷갈릴 수 있는 주제이지만, 멱등성과 리소스 결정권만 잘 생각해 보면 POST와 PUT의 구분은 쉽게 할 수 있다.