概況
Restful強(qiáng)調(diào)的是接口模塊的概念,每個模塊都是獨(dú)立的夜赵,每個模塊的接口方法都是統(tǒng)一的和單一的,即CRUD方法組成乡革。
1寇僧、盡量使用JSON,避免使用XML
2沸版、要有版本號
- 將API的版本號放入U(xiǎn)RL https://api.example.com/v1/
- 版本號放在HTTP頭信息中
3嘁傀、名詞
每個網(wǎng)址代表一種資源,所以網(wǎng)址中不能有動詞视粮,只能有名詞细办,而且所用的名詞往往與數(shù)據(jù)庫的表格名對應(yīng)。一般來說蕾殴,數(shù)據(jù)庫中的表都是同種記錄的"集合"笑撞,所以API中的名詞也應(yīng)該使用復(fù)數(shù)。
4钓觉、資源的具體操作類型茴肥,由HTTP動詞表示
- GET(SELECT):從服務(wù)器取出資源(一項(xiàng)或多項(xiàng))。
- POST(CREATE):在服務(wù)器新建一個資源荡灾。
- PUT(UPDATE):在服務(wù)器更新資源(客戶端提供改變后的完整資源)瓤狐。
- PATCH(UPDATE):在服務(wù)器更新資源(客戶端提供改變的屬性)瞬铸。
- DELETE(DELETE):從服務(wù)器刪除資源。
5础锐、返回消息
返回狀態(tài)碼嗓节,提示信息,內(nèi)容