🔎 HTTP method

　REST(Representational State Transfer) 는 웹 아키텍처의 형식으로, 자원을 정의하고, 자원에 대한 상태를 주고받는 방식을 규정한 아키텍처이다. REST는 분산 웹 시스템을 위한 표준적인 접근 방식으로 사용된다.

　RESTful API는 REST 아키텍처를 따르는 웹 서비스의 표준이며, 주로 HTTP 프로토콜을 기반으로 구현된다. 웹 서비스의 표준으로 사용되는 RESTful API는 HTTP method(GET, POST, PUT, DELETE 등)를 사용하여 자원에 대한 CRUD(Create, Read, Update, Delete) 작업을 수행한다. RESTful API는 간단하고 확장 가능한 인터페이스를 제공하여 다양한 클라이언트와 서버 간의 통신을 돕는다.

　HTTP(HyperText Transfer Protocol)는 클라이언트와 서버 간의 통신을 위한 프로토콜이다. HTTP 메서드는 클라이언트가 서버에게 어떤 동작을 수행할 것인지를 지정하는데 사용한다. HTTP 메서드를 통해서 웹 서비스에서 필요한 데이터를 요청하거나 전송한다.

---

1) GET (read)

　서버로부터 데이터를 가져올 때 사용되며, 요청된 데이터는 URL의 쿼리 문자열에 포함될 수 있다. GET 요청은 주로 서버에 데이터를 전송하지 않고 리소스를 요청할 때 사용된다. 서버의 상태나 데이터를 변경시키지 않으므로 idempotent한다. 동일한 GET 요청을 여러 번 수행해도 항상 동일한 응답을 한다.

Body: Body 값이 존재하지 않는다.
Content-Type: Content-Type 헤더는 GET 메소드에 필수는 아니다. 대부분의 경우 클라이언트가 요청한 데이터를 서버가 어떤 형식으로 반환할지를 나타내기 위해 사용된다.

2) POST (create)

　클라이언트가 서버에 데이터를 보낼 때 사용된다. 주로 HTML의 <form> 요소에서 사용되며, 데이터는 본문에 포함된다.

Body: Body 값은 POST 데이터로 사용되며, 주로 HTML 폼 데이터나 JSON 형식의 데이터를 전송할 때 사용된다.
Content-Type: 전송되는 데이터의 형식을 나타내기 위해 Content-Type 헤더가 사용된다. (application/x-www-form-urlencoded, multipart/form-data, application/json 등)

3) PUT (update)

　서버에 새로운 리소스를 생성하거나 기존의 리소스를 수정할 때 사용된다. 클라이언트는 리소스의 URI를 지정하고 해당 URI에 대한 데이터를 전송한다. 동일한 데이터로 여러 번 PUT을 수행해도 최종적으로는 동일한 상태로 유지된다.(idempotent)

Body: 업데이트할 데이터가 Body 값에 포함된다.
Content-Type: 업데이트되는 데이터의 형식을 나타내기 위해 Content-Type 헤더가 사용된다.

4) DELETE (delete)

　서버에서 지정된 리소스를 삭제할 때 사용된다. 클라이언트는 삭제할 리소스의 URI를 지정하여 서버에 요청을 보낸다. 동일한 DELETE 요청을 여러 번 수행하더라도 삭제된 자원은 없으므로 결과가 동일하다.(idempotent)

Body: 삭제할 데이터를 명시하는 Body 값이 포함될 수 있지만, Body 값이 무시되기도 한다.
Content-Type: 일반적으로 사용되지 않는다.

---

5) PATCH

　PUT 메서드와 비슷하지만, 리소스의 일부만을 수정할 때 사용된다. 클라이언트는 수정할 리소스의 URI를 지정하고 수정할 데이터를 요청 본문에 포함하여 서버에 요청을 보낸다.

6) HEAD

　GET 메서드와 비슷하지만, 주로 리소스의 메타데이터를 확인할 때 사용한다. 리소스의 헤더 정보만을 반환하고 실제 데이터는 반환하지 않는다. GET과 마찬가지로 idempotent한다.

7) OPTIONS

　서버가 지원하는 메서드를 확인하거나 리소스에 대한 특별한 옵션을 요청할 때 사용한다. Idempotent한다.

8) TRACE

　요청이 서버에 도달했을 때 어떻게 변경되었는지 확인하기 위해, 요청 메시지를 서버에게 되돌려 받을 때 사용된다. 보안상 이유로 대부분 비활성화되어 있다.

9) CONNECT

　프록시를 통해 연결을 설정할 때 사용한다. 주로 HTTPS의 터널링을 위해 사용한다.

---

🤔 Idempotent 멱등성

　HTTP 메소드의 Idempotent(멱등성) 은 동일한 요청을 여러 번 수행하더라도 그 결과가 동일하게 유지되는 특성을 갖는다. 멱등성은 HTTP 메서드의 안전성(safe)과 유사하지만 약간 다르다. 클라이언트가 네트워크 문제, 타임아웃 등으로 인해 이전 요청이 실패하여 동일한 요청을 다시 보내더라도 안전하게 처리한다.

　GET, HEAD, PUT, DELETE, OPTIONS가 Idempotent를 갖는다.

---

🤔 POST vs PUT

• POST

  -주로 새로운 리소스를 생성할 때 사용
  -요청이 수행될 때마다 새로운 리소스가 생성되며, 생성된 리소스의 URI는 서버에 의해 결정됨
  -주로 데이터를 전송할 때 사용되며, 서버가 요청을 처리하면 새로운 리소스가 생성됨

• PUT

  -주로 특정 리소스를 업데이트할 때 사용
  -요청된 리소스가 서버에 이미 존재한다고 가정하고, 해당 리소스를 업데이트한다. 만약 해당 리소스가 존재하지 않으면 새로운 리소스를 생성함
  -PUT 요청은 idempotent하며, 같은 요청을 여러 번 보내도 항상 동일한 결과를 반환
  
  

🤔 PUT vs PATCH

• PUT

  -리소스 전체를 업데이트 = 요청된 리소스의 전체 내용을 새로운 데이터로 대체
  -PUT 요청은 리소스의 모든 필드를 제공해야 함. 만약 일부 필드만 제공된다면 누락된 필드는 비어있는 값으로 업데이트

• PATCH

  -리소스의 일부를 업데이트, PUT과 달리 전체 리소스를 대체하는 것이 아니라 일부 필드만 업데이트
  -PATCH 요청은 리소스의 특정 필드만을 제공하여 해당 필드만 업데이트. 다른 필드는 안 됨
  -일부를 수정하는 데 사용되므로, 요청된 데이터에는 업데이트할 필드만 포함