RESTful規範風格

在RESTful架構中,每個網址代表一種資源(resource),所以網址中不能有動詞,只能有名詞,而且所用的名詞往往與數據庫的表格名對應。一般來說,數據庫中的表都是同種記錄的"集合"(collection),所以API中的名詞也應該使用複數。
舉例來說,有一個API提供動物園(zoo)的信息,還包括各種動物和僱員的信息,則它的路徑應該設計成下面這樣。
https://api.example.com/v1/products
https://api.example.com/v1/users
https://api.example.com/v1/employees

HTTP請求方式
對於資源的具體操作類型,由HTTP動詞表示。
常用的HTTP動詞有下面四個(括號裏是對應的SQL命令)。
GET(SELECT):從服務器取出資源(一項或多項)。
POST(CREATE):在服務器新建一個資源。
PUT(UPDATE):在服務器更新資源(客戶端提供改變後的完整資源)。
DELETE(DELETE):從服務器刪除資源。

下面是一些例子。
GET /product:列出所有商品
POST /product:新建一個商品
GET /product/ID:獲取某個指定商品的信息
PUT /product/ID:更新某個指定商品的信息
DELETE /product/ID:刪除某個商品
GET /product/ID/purchase :列出某個指定商品的所有投資者
get /product/ID/purchase/ID:獲取某個指定商品的指定投資者信息

 

詳情鏈接:http://www.ruanyifeng.com/blog/2014/05/restful_api.html

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章