Jimmy 的架站筆記

雖然已經每天跟 git 為伍了，也有把常用指令整理整理在一個 markdown 檔，但還是放到網頁上在開發的時候比較容易看~

1. 為什麼需要 API document 在上一篇 寫完 API 後，接著就是要來寫 document 了，通常後端工程師寫完 API 後必須產生相對應的 API document 才能讓前端工程師知道丟什麼樣格式的 http request 才會拿到什麼樣的 http response，以 這個網站為例，他們有提供 API 給開發者串接，因此 API 的 document 就需要寫得越清楚越

Node.js RESTful API 在上一篇 我們設計好了我們的 API，目前 API 的示意圖如下（點圖可以放大）： 在這篇我們就要來實作 Node.js RESTful API 的部分了。

在上一篇 提到了為什麼需要 database migration，接下來就要開始設計 RESTful API 了！ 如果對 API 的概念還不清楚的話可以參考這篇：，如果想先試著從前端串 API 的話可以參考這篇：。 1 在沒有 RESTful API 之前 在提 RESTful API 之前我們先來說個故事：小明和小華是公司的菜雞後端工程師，兩個是同期進來的，在好不容易過了適用期之後

相信很多人在 import express 的時候都知道要使用 bodyParser，否則會拿不到 request 的 body： 一直都知道要這樣用，但卻不太知道為什麼，再加上之前用 Node.js 寫 http server 的時候，在沒有用 bodyParser 的情況下去 console.log(req.body) 是 undefined，讓我又覺得更奇怪了，所以決定深入探討一下箇中原因！

之前雖然寫過 ，但並沒有導入 ESLint 和 Prettier 來決定 coding style，這篇簡單記錄一下如何建立 Google TypeScript Style 的 Node.js 環境。 Google 有將該 style guide 包成套件 ( gts ) 方便專案引入使用，因此我們直接根據 來 import google TypeScript style guide。

在上一篇： 簡單用 Node.js 架設 http server 後，接著會在 Node.js 寫 API 來操作 database，在這之前我們需要先了解一下 database migration( 資料庫遷移 )，以及為什麼需要 database migration。

接著就要來實作用 Node.js 來架設一個 http server 了！這一系列的文章都會用 TypeScript 來寫，TypeScript 是 JavaScript 的嚴格超集，最主要的差別就是可以為變數加上型別，讓大型專案更加好維護。

PostgreSQL 教學 在上一篇介紹完 的差別之後，接下來就要進到實作的部分了，架設一個 database server ，這篇以 PostgreSQL 為例。 PostgreSQL ( 發音：Post-Gres-Q-L ) 是一個免費且完整開放原始碼的資料庫系統，不僅是最常用的幾個 RDBMS 之一，還有針對大量數據處理推出 JSONB 的格式，算是有針對 noSQL 優化的 RDBMS。

簡單筆記一下如何一次更新 package.json 中的所有 dependencies