[HTTP] : RESTful API 란 무엇인지 ?

RESTful API 란 ?

웹 서비스를 위한 소프트웨어 아키텍처 스타일.

RESTful API 는 자원(데이터)을 고유한 URI로 표현을 하고,
여러 HTTP 메서드를 사용하여 자원에 대한 조작을 수행하는 방식으로 동작한다.

자원이란 ?

= 데이터.

데이터는 고유한 URI로 식별된다.

'/posts'
'/posts/:_id'
'/comments/:postId'
'/comments/:_id'

 

위와 같이 해당하는 고유한 URI를 가지고 자원 (데이터)에 접근이 가능하다.

HTTP 메서드

 

내가 사용한 HTTP 메서드는 아래 4개의 메서드이다.
가장 빈번하게 사용되는 대표적인 메서드이기도 하다.

• POST - 데이터 생성 (Create)

나는 POST 메서드를 사용할때는, /posts라는 URI에 접근해서 사용했다.

• GET - 데이터 조회 (Read)

GET 메서드를 사용할때는 /posts URI로 전체 데이터를 조회하거나.
/posts/:_id URI를 통해 특정 데이터의 id값에 접근해서 해당 자원만 조회하기도 하였다.

• PUT - 데이터 수정 (Update)

PUT 메서드를 사용할때는 특정 자원의 _id 값에 접근해서 자원을 수정했다.

• DELETE - 데이터 삭제 (Delete)

DELETE 메서드도 하나의 값에 접근해서 사용했기 때문에 수정과, 데이터 상세조회 URI와 동일하다.

URI 디자인

RESTful API에서 URI는 데이터를 나타내는데 사용된다.
계층적인 구조를 가질 수 있기 때문에 해당 데이터와의 관계를 표현할 수 있다.

예시 ) /posts/:345bhbsdfh7732fh 는 :뒤에 위치한 params를 가지고 해당 value 값을 가지는 데이터에 접근이 가능한 것이다.
특정 데이터의 수정과 삭제 및 상세 조회를 위와 같이 params 자리에 해당 자원의 고유 id 값을 value 로 받아서 접근했다.

데이터 포맷

RESTful API는 다양한 데이터 포맷을 지원한다고 한다.

대표적으로 가장 일반적인 JSON 형태부터 몇 번 들어본 XML, CSV 또는 YAML 등도 사용될 수 있다고 한다.

클라이언트 <------> 서버는 선택한 데이터 형태를 기반으로 데이터를 주고 받는다.

 

#RESTful_API #개념정리 #URI #params #res #req #HTTP #method
#POST #GET #PUT #DELETE #CRUD