什麼是 REST/RESTful ?
Representational State Transfer，簡稱 REST，它是一種網路架構風格，近幾年來 REST 的概念已經被實作在大型網路系統中，而在 Web Service 中使用 REST 概念被實作出來的 API 就簡稱為 RESTful API 他是使用 HTTP 的協定完整定義 Web Service 在 HTTP Request 的各種流程。
HTTP Request 方法
HTTP 本身就是 REST 的實作，所謂的 HTTP Request 定義了八種請求方法分別為：
- GET
- 此方法只能向指定的資源要求取得資料，並不會更動到內部資源
- HEAD
- HEAD 跟 GET 方法類似只差別在它並不會回傳你所請求的資源在 body 上，只回傳 HTTP header
- POST
- 向指定的資源提交資料
- PUT
- 向指定資源位置提交更新內容
- DELETE
- 向指定資源位置請求刪除內容
- CONNECT
- HTTP/1.1協議中預留給能夠將連接改為管道方式的代理服務器
- OPTIONS
- 此方法可使服務器傳回該資源所支持的所有 HTTP 請求方法
- TRACE
- 回顯服務器收到的請求，主要用於測試或診斷
REST 傳輸的要求
經由 wiki 定義 REST 風格最重要的架構約束有六個:
- 客戶-服務器（Client-Server）
- 客戶端和服務器結構
- 無狀態（Stateless）
- 連接協議具有無狀態性
- 緩存（Cache）
- 能夠利用Cache機制增進性能
- 統一接口（Uniform Interface）
- 一致性的操作界面
- 分層系統（Layered System）
- 層次化的系統
- 按需代碼（Code-On-Demand，可選）
- 例如 JavaScript
RESTful API 的安全性
我們設計 API 時，要保證 RESTful API 的安全性，原因是 PUT 或 DELETE 其實並不安全在沒有權限認證下任何人都可以存取此方法，總不能輕易地隨意讓一位陌生人來更動你的資料對吧？因此若安全性沒有做足容易就成為駭客攻擊的對象。
-
基本流程如下：
會員機制(帳號密碼) -> 服務端驗證成功並取得一組 API token -> 使用此組 token 訪問 API 資源
RESTful API 的 URI 命名
- URL root: https://example/api/
- 建議 URI components 都用小寫
- URI 使用名詞而不是動詞，且建議使用複數
- BAD
- /getProducts
- /listOrders
- /getProductsById?orderId=1
- GOOD
- GET => /products (回傳所有產品)
- POST => /products (新增產品)
- GET => /products/4 (取得單筆產品)
- PUT => /products/4 (修改單筆筆產品)
- DELETE => /products/4 (刪除單筆產品)
何謂 MVC ?
MVC 一種軟體架構模式，把系統分成三個種核心，分別為:Model, View, Controller，這三個套用在 Web 分別為前端 HTML+CSS (View)，後端 API 資料庫(Model)，控制後端資料庫的接口 JavaScript (Controller)
- Model
- 後端資料庫進行運作
- View
- 前端畫面與邏輯顯示
- Controller
- 處理控制流程和回應，以路由以傳遞資料為主
MVC 架構優點
優點如下:
- 有例於團隊開發
- 程式方便管理
- 程式擴充性高
- 使程式結構更加直覺
- 可讀性高
結論
本篇文章解釋了 RESTful API 定義與規範，可以讓開發者了解其功能性，此外建立良好的 MVC 架構有助於日後程式開發的茁壯，直覺、簡單、快速才是一個良好的 API 設計。
後記: 可以參考restful-webapi-design-guide
鼓勵持續創作，支持化讚為賞！透過下方的 Like 拍手👏，讓創作者獲得額外收入~
版主10在2020年首次開設YouTube頻道，嘗試拍攝程式教學。想要了解更多的朋友歡迎關注我的頻道，您的訂閱就是最大的支持～如果想學其他什麼內容也歡迎許願XD
https://www.youtube.com/channel/UCSNPCGvMYEV-yIXAVt3FA5A
https://www.youtube.com/channel/UCSNPCGvMYEV-yIXAVt3FA5A