HTTP 메서드

모든 개발자를 위한 HTTP 웹 기본 지식 - 인프런 | 강의

API URI 설계

• 가장 중요한 것은 리소스 식별
• 행위는 모두 배제하고 대상을 리소스로 식별
• 회원 목록 조회이면 회원이 리소스
• 계층 구조상 상위를 컬레션으로 보고 복수 단어 사용 권장
• 행위에 대한 구분이 되지 않음 → HTTP 메서드로

HTTP 메서드

HTTP 메서드 종류

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

GET

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

POST

• 요청 데이터 처리
• 메시지 바디를 통해 서버로 요청 데이터 전달
• 서버는 요청 데이터를 처리
  • 메시지 바디를 통해 들어온 데이터를 처리하는 모든 기능을 수행
• 주로 전달된 데이터로 신규 리소스 등록, 프로세스 처리에 사용
• 사용하는 경우
  • 새 리소스 생성
  • 요청 데이터 처리
  • 다른 메서드로 처리하기 애매한 경우

PUT

• 리소스를 대체
  • 리소스가 없으면 생성
• 클라이언트가 리소스를 식별
  • 클라이언트가 리소스 위치를 알고 URI 지정
  • POST와 차이점

PATCH

• 리소스 부분 변경

DELETE

• 리소스 제거

HTTP 메소드의 속성

• 안전
• 멱등
• 캐시가능

안전

• 호출해도 리소스를 변경하지 않음
• GET, HEAD은 안전

멱등

• f(f(x)) = f(x)
• 몇 번을 호출하든 결과가 동일
• GET : 여러번 조회해도 조회 결과 동일
• PUT : 같은 요청을 여러 번 해도 최종 결과 동일
• DELETE : 같은 요청을 여러 번 해도 삭제된 결과 동일
• POST : 여러번 호출하면 중복해서 등록 가능 → 멱등 아님
• 활용
  • 자동 복구 매커니즘
• 외부 요인으로 중간에 리소스가 변경되는 것은 고려하지 않음

캐시가능

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