REST風格的接口,這樣的詞彙總是出現在耳邊,然後又沒有完全的了解,您是不是有和我相同的疑問呢?那我們一起來一探究竟吧!
REST是Representational State Transfer
的首字母,翻譯成中文就是表現層狀态轉移,但一般人是弄不懂它的具體含義的。
知乎有位大神Ivony解釋的非常清楚:
用URL定位資源,用HTTP動詞(GET,POST,DELETE,DETC)描述操作。
在設計web接口的時候,REST主要是用于定義接口名,接口名一般是用名詞寫,不用動詞,那怎麼表達“擷取”或者“删除”或者“更新”這樣的操作呢——用請求類型來區分。
比如,我們有一個friends接口,對于“朋友”我們有增删改查四種操作,怎麼定義REST接口?
增加一個朋友,uri: generalcode.cn/v1/friends 接口類型:POST
删除一個朋友,uri: generalcode.cn/va/friends 接口類型:DELETE
修改一個朋友,uri: generalcode.cn/va/friends 接口類型:PUT
查找朋友,uri: generalcode.cn/va/friends 接口類型:GET
上面我們定義的四個接口就是符合REST協定的,請注意,這幾個接口都沒有動詞,隻有名詞friends,都是通過Http請求的接口類型來判斷是什麼業務操作。
舉個反例:generalcode.cn/va/deleteFriends 該接口用來表示删除朋友,這就是不符合REST協定的接口。
一般接口的傳回值是JSON或者XML類型的,筆者在網際網路的工作經驗一般都是JSON類型的。
用HTTP Status Code傳遞Server的狀态資訊。比如最常用的 200 表示成功,500 表示Server内部錯誤,403表示Bad Request等。(反例:傳統web開發傳回的狀态碼一律都是200,其實不可取。)
那這種風格的接口有什麼好處呢?
前後端分離。前端拿到資料隻負責展示和渲染,不對資料做任何處理。
後端處理資料并以JSON格式傳輸出去,定義這樣一套統一的接口,在web,ios,android三端都可以用相同的接口,是不是很爽?!
轉載于:https://www.cnblogs.com/setsailgo/p/9899130.html