[Node.js] Node.js REST API란?

🎯 Node.js REST API란?

• REST + API
• REST 아키텍처를 준수하는 웹 API
• RESTful API라고 부르기도 한다.

 

📝 API란

• Application Programming Interface
• 서비스나 프로그램 간에 미리 정해진 기능을 실행할 수 있도록 하는 규약
• 운영체제 API, 프로그램 언어 API, 웹 API 등이 있다.

 

📝 REST 란?

• REpresentational State Transfer
• 웹에서 자료를 전송하기 위한 표현 방법에 대한 아키텍처
• REST를 정확하게 구현하기 위해선 많은 제한조건이 있지만, 기본적인 REST 가이드를 따르면 조금 더 좋은 구조의 API를 구성할 수 있다.

 

📕 HTTP Method의 사용

• REST API는 API의 동작을 HTTP method + 명사형 URL로 표현한다.
• /posts라는 URL은 '게시글'이라는 자원을 가리킨다고 할 때
  • GET- 가져오기
  • POST - 새로 만들기
  • PUT - 수정하기
  • DELETE - 삭제하기
  • 의 HTTP method와 결합하여 API 동작을 정의하여야 한다.

 

📕 URL 표현법

• REST API URL의 자원은 복수형으로 표현되며, 하나의 자원에 대한 접근은 복수형 + 아이디를 통해 특정 자원에 접근한다.
• /posts는 '게시글 전체'를 칭하는 URL이라고 할 때, /posts/1 은 '1번 게시글'이라는 자원을 표현함

 

📕 계층적 자원

• REST API는 URL을 통해 자원을 계층적으로 표현한다.
• /users/1/posts라는 URL은 '1번 유저의 게시글 전체'라는 자원을 나타낸다.

 

🏷 요약

• REST API는 REST 아키텍처를 준수하는 웹 API를 의미하며, URL을 통한 자원의 표현 방법과, HTTP method를 통한 API 동작의 정의 정도만 사용해도 훌륭한 REST API를 구현할 수 있다.

 

📌 참고

• What is API: Definition, Types, Specifications, Documentation