REST API란

 

---

 

REST API ( Representational State Transfer Application Programming Interface)

 

REST는 아키텍처 원칙이다.

쉽게 말해서,

서버와 클라이언트간에 무언가 정보교환이 존재할 때,

REST 아키텍처가 정해놓은 규칙에 따라 요청 및 응답을 하는 것이다.

 

 

   

API는 애플리케이션 프로그래밍 인터페이스의 약자로,

애플리케이션 소프트웨어를 구축하고 통합하는 프로토콜 세트이다.

API는 정보를 제공하는 자와 정보를 사용하는 자가 존재하고, 사용자의 호출과 제공자의 응답으로 이루어져 있다.

 

요약해서 API를 구현할 때, REST아키텍처에 따라 개발을 하게 되면, 

해당 API는 REST API라고 간주될 수 있는 것이다.

 

 

출처: https://ichi.pro/ko/nodejs-mich-mongoleul-sayonghayeo-hwagjang-ganeunghan-restful-apileul-gaebalhago-baepohabnida-38666913058668

REST API 설계

  - URL 주소는 [동사]가 아닌 [명사]들로 이루어지도록 구현

  - 자원에 대한 행위는 HTTP Method로 표현

 

---

 

Client -> API 과정에서 GET/POST/DELETE/PUT은 REST의 구성 중 행위에 해당하는 HTTP Method 표현 방식이다.

해당 HTTP Method로 자원을 가지고 어떤 행위를 할지 결정 짓는 역할을 한다.

 

예를 들어 호출 URI가 group/insert 인 경우는, REST 아키텍처에 위배되는 행위라고 볼 수 있다.

insert는 삽입하다라는 동사로 '삽입하다' 라는 행위 자체는 HTTP Method로 표현하는 것이 맞다.

 

---

 

[HTTP METHOD 의 역할 구분]

  POST : 데이터를 생성한다.

  PUT : 데이터를 수정한다.

  GET : 데이터를 조회한다.

  DELETE : 데이터를 삭제한다.