RESTful風格接口和特性

1、RESTful的特性

資源： 可以用一個URL（統一資源定位符）指向它，每種資源對應一個特性的URL。

URI： 統一資源標誌符，用來唯一的標識一個資源
URL：統一資源定位符，是一種具體的URI，即URL可以用來標識一個資源，而且還指明瞭如何locate這個資源。
URN：統一資源名稱，是通過名字來標識資源，比如mailto:[email protected]

表現層： 把資源具體呈現出來的形式。

比如，文本可以用txt格式表現，也可以用HTML格式、XML格式、JSON格式表現，甚至可以採用二進制格式。

狀態轉換： 每發出一個請求，就代表了客戶端和服務器的一次交互過程，是服務器端發生“狀態轉換”。

HTTP協議裏面，四個表示操作方式的動詞：GET（獲取資源）、POST（新建資源）、PUT（更新資源）、DELETE（刪除資源）。

2、資源的URL設計

• 通過URL來表示資源

主資源：/api/coupon/{id}
子資源：/api/coupon/{id}/pictures（圖片集合）

• 單數 & 複數

/api/users/1
/api/user/1

• 相對路徑 & 請求參數

// 參數放在路徑中
/api/coupon/searchCouponDetail/1745486430339072 

// 拼接的方式
/api/coupon/searchCouponDetail?couponId=1745486430339072&type=product 

？後拼接參數的方式：這種方式一般作爲過濾資源