HTTP API GET,POST

이전 글에서 API의 설계하는 방법을 배웠고 API의 동사에 해당하는 HTTP 메서드에 대해서 알아보자!!

 

주요 메서드

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

기타 메서드 

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

GET

- 리소스 조회

- 서버에 전달하고 싶은 데이터는 query(쿼리 파라미터, 쿼리 스트링)을 통해서 전달

- 메시지 바디를 사용해서 데이터를 전달할 수 있지만, 지원하지 않는 곳이 많아서 권장하지 않음

-> 실무에서 get으로 메시지 바디를 사용 x , 지원하지 않는 서버가 존재

 

GET으로 조회할때

ex1)

GET/search?q=hello&hl=ko HTTP/1.1

Host : www.google.com

 

ex1) member/100을 조회할때

 

클라이언트에서 서버로 조회를 요청할때

GET/members/100 http/1.1

Host:localhost:8080

 

서버에서 클라이언트로 데이터를 보낼 때

/member/100

{

    "username" : "hyeok"

    "age" : 26

}

 

서버에서 보낸 데이터를 클라이언트가 받을 때

HTTP/1.1 200 OK

Content-type : application/json

Content-Length : 34

{

    "username" : "hyeok",

    "age" : 26

}

 

POST

- 요청 데이터 처리

- 메시지 바디를 통해 서버로 요청 데이터 전달

- 서버는 요청 데이터를 처리

    - 메시지 바디를 통해 들어온 데이터를 처리하는 모든 기능을 수행

- 주로 전달된 데이터로 신규 리소스 등록, 프로세서 처리에 사용

 

POST로 데이터 전달할때

 

클라이언트가 서버에 데이터 전달

POST/members HTTP/1.1

Content-Type: application/json

{

    "username" : "hyeok",

    "age" : 26

}

 

서버가 클라이언트에 데이터를 전달할 때

HTTP/1.1 Created

Content-Type : application/json

Content-Length : 34

Location:/members/100

{

    "username" : "hyeok",

    "age" : 20

}

 

** POST(정리)

-> 요청 데이터를 어떻게 처리한다는 뜻일까??

1. 세 리소스 생성(등록)

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

2. 요청 데이터 처리

- 단순히 데이터를 생성하거나, 변경하는 것을 넘어 프로세스를 처리해야 하는 경우

- 예) 주문에서 결제완료 -> 배달시작 -> 배달완료 처럼 단순히 값 변경을 넘어 프로세스의 상태가 변경되는 경우

- POST /orders/{orderId}/start-delivery(컨트롤 URI)

3. 다른 메서드로 처리하기 애매한 경우

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

- 애매하면 POST