HTTP - 메서드

HTTP API를 설계해보자!

회원 정보 관리 API를 다음과 같이 설계한다고 해보자.

 

* 회원 목록 조회: /read-member-list

* 회원 조회: /read-member-by-id

* 회원 등록: /create-member

* 회원 수정: /update-member

* 회원 삭제: /delete-member

이런 URI 설계는 아름답지 못하다! 가장 중요한 것은 리소스 식별

회원을 등록하고 수정하고 조회하는 것이 리소스가 아님 -> '회원' 이라는 개념 자체가 바로 리소스

따라서 등록/수정/조회 등의 행위는 전부 배제

 

위의 개념에 따라서 다시 설계해보자

* 회원 목록 조회: /member

* 회원 조회: /member/{id}

* 회원 등록: /member/{id}

* 회원 수정: /member/{id}

* 회원 삭제: /member/{id}

-> 구분할 수 없음!

HTTP 메서드(method)

따라서 리소스와 행위를 분리할 수 있는 방법이 바로 method

URI는 리소스만 식별하고 행위는 method로 표현

 

주요 method 5개

1. GET: 리소스 조회

* 서버에 전달하고 싶은 데이터는 query(파라미터, 스트링)를 통해서 전달

* 메세지 바디를 사용해서 전달할 수 있지만 지원하지 않는 곳이 많아 권장하지 않음

2. POST: 요청 데이터 처리, 주로 등록에 사용

* 메세지 바디를 통해 서버로 요청 데이터 전달

* 들어온 데이터를 처리하는 모든 기능을 수행 (주로 신규 리소스 등록, 프로세스 처리에 사용)

* 애매하면 POST

3. PUT: 리소스를 대체, 해당 리소스가 없으면 생성

* 리소스가 있으면 대체, 없으면 생성 (덮어쓰기) -> 부분만 변경하고 싶어도 전체가 덮어씌워짐

* 클라이언트가 리소스를 식별 (POST와의 차이점)

4. PATCH: 리소스 부분 변경

5. DELETE: 리소스 삭제

 

기타 메서드(거의 사용하지 않음)

HEAD: GET과 동일하지만 메세지 부분을 제외하고 상태 줄과 헤더만 반환

OPTIONS: 대상 리소스에 대한 통신 가능 옵션(메서드)을 설명(주로 CORS에서 사용)

CONNECT: 대상 리소스로 식별되는 서버에 대한 터널을 설정

TRACE: 대상 리소스에 대한 경로를 따라 메세지 루프백 테스트를 수행

 

 

HTTP method의 속성

1. 안전: 호출해도 리소스를 변경하지 않음

2. 멱등: f(f(x)) = f(x) -> 여러 번 호출해도 결과가 같음

* GET, PUT, DELETE

* 서버가 TIMEOUT 등으로 정상 응답을 주지 못했을 때 클라이언트가 같은 요청을 다시 해도 되는가? 에 대한 판단 근거로 사용 가능
ex) 자동 복구 매커니즘

3. 캐시 가능: 응답 결과 리소스를 캐시해서 사용해도 되는가?

* GET, HEAD, POST, PATCH -> 캐시 가능

* 하지만 실제로는 GET, HEAD 정도만 캐시로 사용 (POST, PATCH는 본문 내용까지 캐시 키로 고려해야 하는데, 구현이 쉽지 않음)

HTTP 메서드의 속성

* PUT은 멱등인데 왜 PATCH는 멱등이 아닐까?: '부분적으로 바뀐다' 라는 의미는 바꾸는 행위 자체를 호출할 수 있다. PUT은 전체를 덮어 씌우기 때문에 여러 번 호출해도 같지만 '부분적으로 바꾼다' 라는 해당 행위가 멱등일 수도 멱등이 아닐 수도 있음.

ex) 호출하면 나이가 10 증가하는 PATCH 메서드가 존재할 수 있음. 해당 메서드는 여러 번 호출하면 같은 값이 반환되지 않을 수 있음

 

HTTP API 데이터 전송

HTTP API - Collection

-> 서버가 관리하는 리소스 디렉터리(서버가 리소스의 URI를 생성하고 관리)

* POST 기반 등록

HTTP API - Store

-> 클라이언트가 관리하는 리소스 디렉터리

* PUT 기반 등록

HTTP FORM

-> 순수 HTML + HTML FORM 사용 (GET, POST만 지원)

* GET과 POST만 사용하므로 제약이 있음. 따라서 이런 제약을 해결하기 위해 동사로 된 리소스 경로를 사용하기도 한다(컨트롤 URI)