[REST API] 뿌시기 by Node.js & Mongoose

API라는 말을 처음 들은 때가, 아마 어느샌가 N사의 "지도 API"라는 단어가 흥하기 시작한 때였던 것 같다.

 

그때까지만 해도 API하면 생각나는 것은 그냥 "지도"였고, 그 지도 자체를 의미하는 프로그램인 줄 알았다.

 

하지만 더 알아갈수록 빙산의 일각이었음을 깨달았다.

 

API란,

어떤 Web의 사용자인 클라이언트와 정보 제공자인 서버가 HTTP라는 약속된 언어로 통신할 때,

그 서버가 제공하는 메뉴판이라고 보면 된다.

 

레스토랑에서 다양한 음식을 메뉴판으로 제공하는 것과 마찬가지로,

사이트는 서버가 가지고 있는 홈페이지의 모습, 구성요소, 로그인정보 뿐 아니라 서버DB 내 특정 파일 등 다양한 정보를 URL로 제공하는 것이다.

 

즉 클라이언트는 해당 웹사이트에서 제공되는 페이지 등 정보를 보여달라고 URL을 주소창에 직접 입력하거나,

해당 URL을 담고 있는 버튼 등을 클릭하여 그 웹페이지만의 맞춤 API를 이용하고 있는 것이다.

 

Convention

POST 메서드의 Route를 정할 때는, 각 세부 페이지가 아닌 그들을 포괄하는 상위 Collection을 이름으로 할 것.

= 게시판 목록처럼 모든 하위 내용들을 한번에 GET하는 URL과 동일하게 설정

 

https://expressjs.com/en/guide/routing.html

Express routing