인프런 커뮤니티 질문&답변

안녕하세요, wisehero님~ 정말 좋은 질문이십니다!! 😊

사실 이 부분이 굉장히 애매하고 흥미로운 부분입니다.

저희가 흔히 REST API 라고 말하는 것이 진정으로 REST 의미에 걸맞는가? 하면 사실은 그렇지 않습니다. (관련해서는 https://youtu.be/RP_f5dMoHFc?si=w0isupnktK3aHaW9 영상을 봐보셔도 좋습니다)

현실적으로 100% REST API를 만들기 위해서는 생각보다 지켜야 할 것도 많고, 해야 할 것도 많죠.

때문에 보통은 API의 URI를 통해 대략적으로 자원의 의미를 파악할 수 있고, Method를 통해 자원의 변화를 파악할 수 있으면 만족하는(?) 편이라고 생각됩니다.

즉, 함께 프로젝트를 만들어 가는 사람들이 만족한다면 그것으로 충분하다는 뜻이죠!!

PATCH와 PUT의 관계도 비슷합니다. 어떤 곳에서는 수정은 무조건 PUT 으로 하기도 하고, 어떤 곳에서는 상황에 따라 PATCH와 PUT을 조금 더 디테일하게 나누기도 합니다. 어떤 방식이 절대적으로 맞다기 보다는 상황가 사람에 따라 선호할 수 있는 부분이라고 생각합니다.

개인적으로는 전자를 선호하는데요, 그 이유는 Entity가 상황에 따라 계속해서 변할 수 있기 때문입니다.

예를 들어 User Entity에 id와 name만 있었다고 해보겠습니다. 여기서 PUT과 PATCH를 구분한다면, 이름을 변경하는 API는 PUT으로 만들어야 합니다. 현재 필드는 name만 존재하니까요.

그런데 시간이 흘러 age 라는 필드도 User에 추가되었다고 해보죠. 그럼, 원래 있던 name만 변경하는 API는 PATCH로 변경되어야 합니다. 그 API는 모든 필드를 수정하는 것이 아니라, age와 name중 name만 수정하기 때문이죠.

이렇게 되면, API의 method를 변경해야 하는데 이런 작업이 쉬운 것은 아닙니다.특히 모바일 앱처럼 버전 관리를 조금 더 세밀하게 해야하는 경우, 상당히 높은 비율의 사용자가 신규 앱 버전으로 업데이트 하지 않는 이상 하위 호환성을 위해 기존의 API 코드를 제거할 수도 없죠. 때문에 프로덕트의 유지비용이 올라가게 됩니다.

결론적으로 PATCH 와 PUT의 적용은 결국 프로덕트를 만들어 가는 사람들이 모여 convention으로 정하는 부분이 아닐까 싶습니다. 답변이 도움이 되었으면 좋겠습니다. 감사합니다! 😊 🙇