[ REST API ] HTTP Methods

 

배경지식

 

* HTTP: HyperText Transfer Protocol의 약자로, 인터넷에서 정보를 송수신하는 프로토콜 (규약)입니다. HTML문서 송수신에 주로 사용됩니다.

 

* REST API: Repersentational State Trasfer API의 약자로, REST라는 규칙에 맞춰 개발 및 제공되는 API를 말합니다.

 

* API: Application Programming Interface의 약자로, 특정 서비스나 응용 프로그램에서 자신들의 서비스 내부의 기능들을 제어할 수 있도록 만들어놓은 인터페이스를 말합니다.

 

---

 

HTTP Methods

 

HTTP Methods란 쉽게말해 HTTP 프로토콜 상에서 데이터가 오가기위한 방식을 말합니다.

HTTP 자체도 프로토콜이기 때문에 전송방법을 나타내는것이 맞지만, 같은 프로토콜에서 조금 더 세부적으로 나뉘어진 개념이라고 보시면 될 것 같습니다.

 

HTTP Methods는 종류가 굉장히 다양합니다. 그중 많이 사용되는 것은 

 

GET

POST
PATCH
PUT
DELETE

 

정도입니다. 나머지는 굉장히 특수한 상황에서만 사용되거나 거의 사용하지 않습니다.

 

 

+) Methods 별로 나누어서 사용하는 이유

 

HTTP 요청이라 해서 다 같은 요청이 아닙니다. 모든 비행기가 사람만 나르는 것은 아니듯이 말이죠. (여객기가 아닌 화물기일수도 있고..)

HTTP 요청의 목적에 따라서 특화된 전송옵션을 제공하거나, 해당 요청의 목적에 따른 서버와 클라이언트 상호간의 명시를 위해 사용합니다.

사실 Methods를 나누는 이유는 전자의 목적이 강합니다.

 

 

1. GET

 

특정 자료에 대한 정보를 요청하는 메소드입니다.

쉽게 말하자면, 우리가 보는 웹페이지나 일반적으로 공개된 정보들을 서버에서 받아올 때 이 메소드를 사용합니다.

일반적으로 url을 입력하고 Enter를 치면 GET 메소드로 서버에 요청을 보냅니다.

 

 

+) Parameter Passing

 

자료만 요청하는 메소드라고 해도, 서버에 정보전달은 필요합니다.

예를들면, 사용자중에 어떤 사용자의 정보를 불러올지, 아니면 리스트의 여러 값들중 어떤 값을 가져올지 등..

 

이를 위해 사용가능한 방법이 3가지 있습니다.

그중 여기에서는 url param과 query param만 알려드릴겁니다. 나머지 하나는 POST Methods를 설명하고 알려드릴게요 ;)

 

1. url param (=path variable)

 

url일부를 데이터가 들어가는 위치로 지정하여 데이터를 보냅니다.

 

GET http://test_server.tsv.com/user/:username

 

서버에서 사용자의 정보를 불러오기 위해 위의 url을 사용한다고 가정한다면, "http://test_server.tsv.com"서버는 요청이 들어올 때 이런식으로 반응할 겁니다:

 

서버: "경로가 '/user/:username'인 'GET'요청이 들어오면, 'username'을 DB에서 찾아서 다시 보내줘야지 "

 

이런 url을 실제 사용자가 보낼때는, 주소창에 보통 이런식으로 입력합니다:

http://test_server.tsv.com/user/john

이러면 서버에서 "john"이라는 이름을 가진 사람의 정보를 찾아 보내겠죠.

그럼 사용자 입장에서 저자리에 이런 정보가 들어간다고 알 수 있을까요?

없습니다. 서버 개발자가 위와 같이 표현해줘야 저기에 '사용자이름'이라는 정보가 들어가는것을 알 수 있습니다.

 

 

2. query param

 

url 뒤에 "?"로 구분시켜서 데이터를 보냅니다.

 

GET http://test_server.tsv.com/user/?username=...

 

서버에서 사용자의 정보를 불러오기 위해 위의 url을 사용한다고 가정한다면, "http://test_server.tsv.com"서버는 요청이 들어올 때 이런식으로 반응할겁니다:

 

서버: "경로가 '/user'인 'GET'요청이 들어오면, query에 있는 'username'을 DB에서 찾아서 다시 보내줘야지 "

 

이런 url을 실제 사용자가 보낼때는, 주소창에 보통 이런식으로 입력합니다:

http://test_server.tsv.com/user?username=john

이러면 서버에서 "john"이라는 이름을 가진 사람의 정보를 찾아 보내겠죠.

query의 경우 '&'의 구분을 통해 여러 값을 한번에 보낼 수 있습니다.

 

++) Query String과 Path Variable은 각각 언제 쓰면 좋을까?

https://velog.io/@jcinsh/Query-string-path-variable

올바른 URL 설계 : 1) Query string과 Path Variable 이해하기

 

 

2. POST

 

서버에 자료의 생성을 요청하는 메소드입니다.어떤 사이트에서 회원가입을 위해 정보들을 입력하고 가입버튼을 누르면, 대다수는 이 메소드를 이용해서 입력된 정보들을 전달합니다.

 

 

+) body

 

위에서 설명하지 않았던 3번째 데이터 전송 방식입니다.

 

POST부터 아래에 작성하는 메소드들은 데이터를 보내기 위해 body라는 영역을 사용할 수 있습니다.

이 공간에 데이터를 넣으면 서버에 전송하려는 데이터를 url에 표시되지 않은 상태로 보낼 수 있습니다.

 

 

3. PATCH

 

서버에 저장되어있는 특정 정보를 수정하려고 할 때 이 메소드를 사용합니다. 뒤에 나오는 PUT과 달리 수정할 데이터에 대한 내용만 보내면 됩니다. (물론 서버개발자가 서버를 개발하는 내부 코드에 따라 달라질 수 있습니다. 이 내용은 언제까지나 HTTP 표준으로 한정하여 설명합니다.)

 

4. PUT

 

서버에 저장되어있는 특정 정보를 수정하려고 할 때 이 메소드를 사용합니다. 위에 나오는 PATCH과 달리 기존 데이터를 모두 덮어씌워버리기 때문에 변경할 데이터 뿐만 아니라 유지할 데이터까지 함께 보내야 합니다. (물론 서버개발자가 서버를 개발하는 내부 코드에 따라 달라질 수 있습니다. 이 내용은 언제까지나 HTTP 표준으로 한정하여 설명합니다.)

 

 

5. DELETE

 

서버에 저장되어있는 특정 정보를 삭제하려고 할 때 이 메소드를 사용합니다.