[4] HTTP 메소드

JIN·2021년 12월 9일

http

URI 설계에서 가장 중요한 것은 리소스 식별

리소스와 행위를 분리

리소스의 의미는 무엇일까?

회원을 등록하고 수정하고 조회하는게 리소스가 아니다!

회원이라는 개념 자체가 리소스 이다.

리소스를 어떻게 식별하는게 좋을까?

회원을 등록하고 수정하고 조회하는 것을 모두 배제

회원이라는 리소스만 식별하면 된다. → 회원 리소스를 URI 에 매핑

API URI 설계를 한다고 하자.
회원 목록 조회 /members
회원 조회 /members/{id}
회원 등록 /members/{id}
회원 수정 /members/{id}
회원 삭제 /members/{id}

그럼 얘네들을 어떻게 구분하지?

URI는 리소스만 식별

리소스와 해당 리소스를 대상으로 하는 행위를 분리

→ HTTP 메서드를 사용하면 돼!

GET: 리소스 조회
POST: 요청 데이터 처리, 주로 등록에 사용
PUT: 리소스를 대체, 해당 리소스가 없으면 생성
PATCH : 리소스 부분 변경
DELETE: 리소스 삭제
기타
HEAD: GET과 동일하지만 메시지 부분을 제외하고 상태줄과 헤더만 반환
OPTIONS: 대상 리소스에 대한 통신 가능 옵션을 설명 (주로 CORS에서 사용)
CONNECT : 대상 자원으로 식별되는 서버에 대한 터널을 설정
TRACE: 대상 리소스에 대한 경로를 따라 메시지 루프백 테스트를 수행

GET

리소스 조회
서버에 전달하고 싶은 데이터는 쿼리를 통해 전달
메시지 바디를 사용해서 데이터를 전달할 수 있지만, 권장하지 않음

POST

새 리소스 생성(등록) → 서버가 아직 식별하지 않은 새 리소스 생성
요청 데이터 처리

단순히 데이터를 생성하거나, 변경하는 것을 넘어서 프로세스를 처리해야 하는 경우
• 예) 주문에서 결제완료 -> 배달시작 -> 배달완료 처럼 단순히 값 변경을 넘어 프로세스의 상태가 변경되는 경우
• POST의 결과로 새로운 리소스가 생성되지 않을 수도 있음
• 예) POST /orders/{orderId}/start-delivery (컨트롤 URI)