HTTP METHODS

주요 메소드

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

기타 메소드

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

GET

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

POST

• 요청 데이터 처리
• 메시지 바디를 통해 서버로 요청 데이터 전달
• 서버는 요청 데이터를 처리
  • 메시지 바디를 통해 들어온 데이터를 처리하는 모든 기능을 수행
• 주로 전달된 데이터로 신규 리소스 등록, 프로세스 처리에 사용
• 대상 리소스가 리소스의 고유한 의미 체계에 따라 요청에 포함된 표현을 처리하도록 요청

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

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

2) 요청 데이터 처리

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

3) 다른 메소드로 처리하기 애매한 경우

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

PUT

• 리소스를 대체
  • 있으면 대체, 없으면 생성. 덮어쓰기
  • 리소스를 "완전히" 대체. (기존 리소스를 삭제)
• 클라이언트가 리소스를 식별
  • 클라이언트가 리소스 위치를 알고 URI 지정. POST와의 차이점

PATCH

• 리소스 부분 변경

DELETE

• 리소스 제거

HTTP 메서드의 속성

안전 (Safe Methods)

• 호출해도 리소스를 변경하지 않는다
• GET, HEAD, OPTIONS, TRACE

멱등 (Idempotent Methods)

• f(f(x)) = f(x)
• 한 번 호출하든 두 번 호출하든 100번 호출하든 결과가 같음
• GET, PUT, DELETE
• POST는 멱등이 아님 두 번 호출시 같은 결제가 중복해서 발생
• 활용 : 자동 복구 메커니즘
  • 서버가 TIMEOUT 등으로 정상 응답을 못 주었을 때, 클라이언트가 같은 요청을 다시 해도 되는가에 대한 판단 근거

캐시가능 (Cacheable Methods)

• 응답 결과 리소스를 캐시해서 사용해도 되는가?
• GET, HEAD, POST, PATCH
• 실제로는 GET, HEAD정도만 캐시로 사용
  • POST, PATCH는 본문 내용까지 캐시 키로 고려해야 하는데, 구현이 쉽지 않음