HTTP 메서드

API URI

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

리소스란? 회원이 있을때, 회원에 대해 수정하고 조회하는 것이 리소스가 아니다.
회원이라는 개념 자체가 리소스.

리소스를 어떻게 식별하는게 좋을까?
회원을 등록하고 수정하고 조회하는 것을 모두 배제
회원이라는 리소스만 식별하면 된다. -> 회원 리소스를 URI에 매핑

문제는 모두같은 /members/{id} 를 어떻게 구분할 것이냐???

리소스와 행위를 분리

URI는 리소스만 식별하고, 리소스와 해당 리소스를 대상으로 하는 행위를 분리한다.

• 리소스 : 회원
• 행위 : 조회, 등록, 삭제, 변경

HTTP 메서드

HTTP 주요 메서드

• GET : 리소스 조회
• POST : 요청 데이터 처리, 주로 등록에 사용
• PUT : 리소스를 대체, 해당 리소스가 없으면 생성
• PATCH : 리소스를 부분 변경
• DELETE : 리소스 삭제

기타 메서드

• HEAD : GET과 동일하지만 메세지 부분을 제외하고, 상태 줄과 헤더만 변환
• OPTIONS : 대상 리소스에 대한 통신 가능 옵션(메서드)를 설명
• CONNECT : 대상 자원으로 식별되는 서버에 대한 터널 설정
• TRACE : 대상 리소스에 대한 경로를 따라 메시지 루프백 테스트 수행

GET

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

POST

• 요청 데이터를 처리
• 메세지 바디를 통해 서버로 요청 데이터 전달
• 서버는 요청 데이터를 처리, 메세지 바디를 통해 들어온 데이터를 처리하는 모든 기능 수행
• 주로 전달된 데이터로 신규 리소스 등록, 프로세스 처리에 사용

POST 메서드는 대상 리소스가 리소스의 고유 한 의미 체계에 따라 요청에 포함 된 표현을 처리하도록 요청한다.
이 리소스 URI에 POST 요청이 오면 요청 데이터를 어떻게 처리할지 리소스마다 따로 정해야 한다.

정리
1 . 새 리소스 생성(등록)

• 서버가 아직 식별하지 않은 새 리소스 생성

2 . 요청 데이터 처리

• 단순히 데이터를 생성하고나, 변경하는 것 뿐만 아니라 프로세스를 처리해야 하는 경우
• POST의 결과로 새로운 리소스가 생성되지 않을 수도 있음

3 . 다른 메서드로 처리하기 애매한 경우

• ex) JSON으로 조회 데이터를 넘겨야 하는데, GET 메서드를 사용하기 어려운 경우 --> 애매하면 POST

PUT

• 리소스를 대체 : 리소스가 있으면 대체 없으면 생성, 덮어버린다.
  • 리소스를 완전히 대체한다. 아예 새로운 리소스를 삽입하는 것
• 클라이언트가 리소스를 식별한다. POST와 가장 큰 차이점

PATCH, DELETE

• PATCH : 리소스 부분 변경, PUT과 달리 원본 리소스에 부분만 삽입 하는 것

• DELETE : 리소스를 제거 함.

HTTP 메서드의 속성

• 안전(Safe) : 호출해도 리소스를 변경하지 않는다.

• 멱등(Idempotent) : 여러번 호출해도 결과가 같다. crud중 POST만 멱등하지 않음

  • 활용 : 메서드 요청을 보냈는데 응답이 없을 때.. 같은 요청을 다시 보내봐도 될까?
  • 멱등은 외부 요인으로 중간에 리소스가 변경되는 것 까지는 고려하지 않는다.

• 캐시 가능(cacheable) : 응답 결과 리소스를 캐시해서 사용해도 되는가?

HTTP 메서드 활용

클라이언트에서 서버로 데이터 전송하는 전달 방식은 크게 2가지 이다.

• 쿼리 파라미터를 통한 데이터 전송
  • GET
  • 주로 정렬 필터(검색어)
• 메세바디를 통한 데이터 전송
  • POST, PUT, PATCH
  • 회원 가입, 상품 주문, 리소스 등록, 리소스 변경

클라이언트에서 서버로 데이터 전송시 발생하는 데이터 조회 상황은 4가지 이다.

• 정적 데이터 조회
  • 이미지, 정적 텍스트 문서
• 동적 데이터 조회
  • 주로 검색, 게시판 목록에서 정렬 필터(검색어)
• HTML Form을 통한 데이터 전송
  • 회원 가입, 상품 주문, 데이터 변경
• HTTP API를 통한 데이터 전송
  • 회원 가입, 상품 주문, 데이터 변경
  • 서버 to 서버, 앱 클라이언트, 웹 클라이언트