HTTP 메서드

모든 개발자를 위한 HTTP 웹 기본 지식 강의 중의 일부를 정리한 글입니다.

HTTP 메서드의 종류

API를 설계할 때 리소스(Resource 혹은 Representation)를 식별하는 것이 가장 중요합니다. 리소스와 행위를 분리해서 설계해야하는데 리소스의 행위를 나타내는데 아래의 메서드를 이용하면 됩니다.

GET
- 특정 리소스의 표시를 표시를 요청합니다. 즉, 특정 리소스를 조회할 때 사용합니다.
POST
- 특정 리소스에 엔티티를 제출할 때 쓰입니다. 이는 종종 서버의 상태 변화나 부작용을 일으킵니다.
- 메세지 바디를 통해 서버로 요청 데이터를 전달하고, 서버는 요청 데이터를 처리합니다.
  - 메세지 바디를 통해 들어온 데이터를 처리하는 모든 기능을 수행합니다.
- 주로 전달된 데이터는 신규 리소스 등록, 프로세스 처리에 사용됩니다.
PUT
- 목적 리소스 모든 현재 표시를 요청 payload로 바꿉니다.
- 리소스가 없으면 생성하고, 있으면 대체합니다.
- POST와 차이점은 클라이언트가 리소스의 위치를 정확하게 식별하고 있어야한다는 점입니다.
- 멱등하지 않습니다.
PATCH
- 리소스의 부분만을 수정하는 데 쓰입니다.
DELETE
- 리소스를 제거할 때 쓰입니다.
HEAD
- GET과 유사하지만 메세지 부분을 제외하고, 상태줄과 헤더만 반환
OPTIONS
- 목적 리소스의 통신을 설정하는 데 쓰입니다.
CONNECT
- 목적 리소스로 식별되는 서버로의 터널을 맺습니다.
TRACE
- 목적 리소스의 경로를 따라 메시지 loop-back 테스트를 합니다.

요청을 완료하기 위해서 클라이언트의 추가적인 조치가 필요하다는 의미입니다.
영구 리다이렉션
- 301
  - Moved Permanently
  - 리소스의 URI가 영구적으로 이동한 경우입니다.
  - 리다이렉트시 요청 메서드가 GET으로 변하고, 본문이 제거될수 있습니다.
일시적인 리다이렉션
- 302
  - Found
    - 리다이렉트 요청시 요청 메서드가 GET으로 변하고, 본문이 제거될 수 있습니다.
    - 예시) Post / Redirect / Get → 사용자 입장에서 실수로 새로고침을 해도 Get의 결과화면만 조회됩니다.

오류의 원인이 클라이언트에 있으며, 클라이언트의 잘못된 문법등으로 서버가 요청을 수행할 수 없는 경우입니다.
401
- Unauthorized
- 권한 없음
- 인증이 필요한 리소스에 인증 없이 접근할 경우 발생합니다.
403
- Forbidden
- 인증 자격은 있으나, 서버가 요청을 거부할 때 발생한다.
404
- Not Found
- 찿는 리소스가 없다는 의미, 가장 흔하게 볼 수 있는 오류코드입니다. 또는 권한이 부족한 리소스에 접근할 때 해당 리소스를 숨기고 싶은 경우 사용합니다.