HTTP 메소드 - GET, POST, PUT, PATCH, DELETE in Start line

회원 정보 관리 API를 만들려고 할 때, 5가지 요구사항이 주어진다고 해봅시다.

 

1. 회원 목록 조회

2. 회원 조회

3. 회원 등록

4. 회원 수정

5. 회원 삭제

API URI를 설계할 때는 우선 리소스를 식별하는 것이 중요합니다.

동작은 배제하고 우선 리소스부터 식별하도록 합시다.

여기에서 리소스는 '회원' 이겠죠?

 

리소스를 식별하고 URI 계층구조를 활용해서 설계를 해보면 이렇게 할 수 있습니다.

 

1. 회원 목록 조회 /members

2. 회원 조회 /members/{id}

3. 회원 등록 /members/{id}

4. 회원 수정 /members/{id}

5. 회원 삭제 /members/{id}

 

URI는 리소스만 식별하도록 해주고 동작은 분리하도록 합시다.

리소스 : 회원

동작 : 조회, 등록, 삭제, 변경

 

이제 HTTP 메소드를 사용하면 동작을 수행할 수 있습니다.

메소드를 알아봅시다.

 

HTTP 주요 메소드

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

HTTP 기타 메소드

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

---

HTTP - GET

• 리소스 조회
• 서버에 전달하고 싶은 데이터는 query를 통해서 전달

GET /search?q=hello&hl=ko HTTP/1.1 
Host: www.google.com

GET

Response

---

HTTP - POST

• 요청 데이터 처리
• 메시지 바디를 통해 서버로 요청 데이터 전달
• 서버는 요청 데이터를 처리 (신규 리소스 등록, 프로세스 처리)

이 리소스 URI에 POST요청이 오면 요청 데이터를 어떻게 처리할지 리소스마다 따로 정해야 합니다.

POST는 다음과 같은 기능에 사용됩니다.

 

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

ex) 신규 주문 생성

 

2. 기존 자원에 데이터 추가

 

3. HTML 양식에 입력된 필드와 같은 데이터 블록을 데이터 처리 프로세스에 제공

ex) HTML FORM에 입력한 정보로 회원 가입, 주문 등에 사용

 

4. 게시판, 뉴스 그룹, 메일링 리스트, 블로그 or 유사한 기사 그룹에 메시지 게시

ex) 게시판 글쓰기, 댓글 달기 등

 

POST

Response

---

HTTP - PUT

• body 리소스가 서버에 있으면 대체, 없으면 새로 생성. 쉽게말해 덮어쓰기
• 클라이언트가 리소스 위치를 알고 URI를 지정해야 합니다.

---

HTTP - PATCH

• 리소스 부분 변경 

예를들어 json 에 age와 username필드가 있다고 해봅시다.

 

서버의 members/100에 { age:20, username : "kim" } 이 있을떄

 

PATCH members/100 ... { "age":50 } 을 서버에 보내면 

서버의 members/100 { age:50, username : "kim" } 으로 수정됩니다.

 

PUT과 달리 기존 내용이 지워지지 않습니다.

 

---

HTTP - DELETE

• 리소스 제거

 

---

HTTP 메소드의 속성 

1. 안전 - 호출 시 리소스가 변경되지 않습니다.

안전 메소드 : GET ( 리소스 변경 x , 오로지 조회 )

 

2. 멱등 - 여러 번 호출해도 결과가 똑같습니다.

 

멱등 메소드 : GET, PUT, DELETE

POST X : 여러 번 호출하면 같은 결제가 중복해서 발생할 수 있음.

 

PATCH는 왜 멱등하지 않을까?

age = age + 1을 계속 호출하면 age값이 계속 증가하기 때문..

 

활용 : 자동 복구 메커니즘 / 서버가 정상 응답을 주지 못했을 때, 클라이언트가 같은 요청을 해도 되는지에 대한 판단 근거로 사용합니다.

3. 캐시가능 - 응답 결과 리소스를 캐시해서 사용해도 되는가?

캐시가능 메소드 : GET, POST, PATCH 캐시가능 하지만 실제로는 원본 데이터를 변경하지 않는 GET, HEAD 정도만 캐시로 사용