新手村導讀 - 8: RESTful API
今天我們來介紹現今大多公司會使用的 API 模式 — RESTful API，由於我先假定在座的各位應該都是基礎工程師、應該都知道 API 是什麼(吧)，因此我們直接從 Restful 的部分開始吧。
簡介
REST ，全名為 Representational State Transfer，簡單來說是一種將客戶端與服務實作分離的風格。我們將資源放在那裡，定義 Get、Post等方式去取得對應資源。相較於其他格式，RESTful 更加輕量，並且現代大多的 Web 框架都支持這種格式。關鍵知識
- 資源： RESTful 將所有內容都視為一種資源，而 HTTP 方法就代表使用者要如何與這份資源互動，因此 URL 中不應該再出現其他動詞，取而代之的是名詞或是複合名詞。
- 資源格式： RESTful 支援多種格式，例如 JSON、HTML、XML 等。
- 無狀態性： 不會有緩存，因此每次請求都應該要有所有所需的資訊。
我的小經驗
在實務上，我們很常會需要對同一個資源做不同操作(如同上述第 1 點)，例如取得訂單、調整訂單等，在一般狀況下我們就會需要getOrder 、 addOrder 兩個 API 接口，不過在 RESTful 的架構下，我們可以直接用統一接口、不同 HTTP 方法去處理它們，例如：Route::Get('/order','OrderController@index');
Route::Post('/order','OrderController@add');
這樣對於文件上的統合比較方便，程式上的擴展也會更有彈性、更具可維護性喔。
參考資料:
留言
留言分享你的想法！
你可能也想看
Google News 追蹤
※ 什麼是Web API
API 就是後端開出來讓前端來用的介面，讓前端與後端可以溝通。
API流程：
終端使用者用任何一種裝置進入瀏覽器。
瀏覽器透過 API 向後端發出請求，請求查詢或修改資料。
後端透過 API 收到前端的請求後，取得資料並回應給前端。
前端渲染畫面，終端使用者
※ 原本狀態：伺服器渲染
這是 MVC 架構下的 request / response 示意圖，在這張圖呈現的架構裡，畫面和資料都由同一個架構處理。
伺服器渲染流程：
瀏覽器針對特定網址送出請求。
路由器解析請求後，轉接給對應的 controller。
controller 按照要求，透過
ts-rest 可以實現從服務器到客戶端的全型別安全，可以有效降低前後端溝通血流成河的機率。(´,,•ω•,,)
※ 靜態資源回傳
※ 什麼是靜態資源：
定義：是指事先準備好的資源，這些資源在伺服器上是靜態的、不會隨著每個請求而改變。
資源通常包括：
靜態 HTML 文件。
CSS。
圖像（Image）。
Video。
字體文件：google fonts。
favicon：網頁名稱旁邊的ico
一、什麼是Web Service?
簡單說就是「服務」的概念，人與人間、電腦與電腦間都是一樣的，一個是人與人的一來一回交流，媒介是語言中文，另一個則是個人電腦與伺服器的交流，媒介是HTTP/Internet，那麼有了媒介，就會有共同格式才能做
此為不負責任教學，介面操作依實際情況而有所異動
額外資源參考
[API] 串接 Imgur API 圖床服務，上傳到指定相簿
israynotarray超完整 Express Imgur 套件上傳教學
[前端筆記] 用 axios 串接 imgur API上傳圖片
RPC(Remote Procedure Call)是一種不需要理解底層網路技術就可以透過網路請求服務。主要用於分散式系統中的服務相互呼叫。
架構
Registry：負責將服務發佈成遠端服務，管理遠端服務，提供服務。
RPC Server：負責提供操作介面。
RPC Client：負責透
gRPC是一款跨平台、高性能的RPC框架，他可以在任何環境下執行，主要用於後端為服務開發。在用戶端應用程式中，可以像本地物件那樣呼叫遠端伺服器的方法，因此可以創建出分散式應用。
使用
到https://github.com/protocolbuffers/protobuf/releases下
Accept：用戶端能夠接收的內容類型。
Accept: text/plain, text/html
Accept-Charset：瀏覽器可以接受的字元編碼集。
Accept-Charset: utf8
Accept-Encoding：指定瀏覽器可以支援的web伺服器返回內容壓縮編碼
※ 什麼是Web API
API 就是後端開出來讓前端來用的介面，讓前端與後端可以溝通。
API流程：
終端使用者用任何一種裝置進入瀏覽器。
瀏覽器透過 API 向後端發出請求，請求查詢或修改資料。
後端透過 API 收到前端的請求後，取得資料並回應給前端。
前端渲染畫面，終端使用者
※ 原本狀態：伺服器渲染
這是 MVC 架構下的 request / response 示意圖，在這張圖呈現的架構裡，畫面和資料都由同一個架構處理。
伺服器渲染流程：
瀏覽器針對特定網址送出請求。
路由器解析請求後，轉接給對應的 controller。
controller 按照要求，透過
ts-rest 可以實現從服務器到客戶端的全型別安全，可以有效降低前後端溝通血流成河的機率。(´,,•ω•,,)
※ 靜態資源回傳
※ 什麼是靜態資源：
定義：是指事先準備好的資源，這些資源在伺服器上是靜態的、不會隨著每個請求而改變。
資源通常包括：
靜態 HTML 文件。
CSS。
圖像（Image）。
Video。
字體文件：google fonts。
favicon：網頁名稱旁邊的ico
一、什麼是Web Service?
簡單說就是「服務」的概念，人與人間、電腦與電腦間都是一樣的，一個是人與人的一來一回交流，媒介是語言中文，另一個則是個人電腦與伺服器的交流，媒介是HTTP/Internet，那麼有了媒介，就會有共同格式才能做
此為不負責任教學，介面操作依實際情況而有所異動
額外資源參考
[API] 串接 Imgur API 圖床服務，上傳到指定相簿
israynotarray超完整 Express Imgur 套件上傳教學
[前端筆記] 用 axios 串接 imgur API上傳圖片
RPC(Remote Procedure Call)是一種不需要理解底層網路技術就可以透過網路請求服務。主要用於分散式系統中的服務相互呼叫。
架構
Registry：負責將服務發佈成遠端服務，管理遠端服務，提供服務。
RPC Server：負責提供操作介面。
RPC Client：負責透
gRPC是一款跨平台、高性能的RPC框架，他可以在任何環境下執行，主要用於後端為服務開發。在用戶端應用程式中，可以像本地物件那樣呼叫遠端伺服器的方法，因此可以創建出分散式應用。
使用
到https://github.com/protocolbuffers/protobuf/releases下
Accept：用戶端能夠接收的內容類型。
Accept: text/plain, text/html
Accept-Charset：瀏覽器可以接受的字元編碼集。
Accept-Charset: utf8
Accept-Encoding：指定瀏覽器可以支援的web伺服器返回內容壓縮編碼