REST,以及RESTful接口規(guī)范的講解

REST 是面向資源的求厕,這個(gè)概念非常重要著隆,而資源是通過 URI 進(jìn)行暴露。

REST API 是基于 HTTP的呀癣,所以你的API應(yīng)該去使用 HTTP的一些標(biāo)準(zhǔn)美浦。

REST是一個(gè)標(biāo)準(zhǔn),一種規(guī)范项栏,遵循REST風(fēng)格可以使開發(fā)的接口通用浦辨,便于調(diào)用者理解接口的作用。

在設(shè)計(jì)web接口的時(shí)候沼沈,REST主要是用于定義接口名流酬,接口名一般是用名次寫,不用動(dòng)詞列另,那怎么表達(dá)“獲取”或者“刪除”或者“更新”這樣的操作呢——用請(qǐng)求類型來區(qū)分芽腾。

比如,我們有一個(gè)friends接口页衙,對(duì)于“朋友”我們有增刪改查四種操作摊滔,怎么定義REST接口?

增加一個(gè)朋友店乐,uri: generalcode.cn/v1/friends 接口類型:POST

刪除一個(gè)朋友艰躺,uri: generalcode.cn/va/friends 接口類型:DELETE

修改一個(gè)朋友,uri: generalcode.cn/va/friends 接口類型:PUT

查找朋友眨八,uri: generalcode.cn/va/friends 接口類型:GET

上面我們定義的四個(gè)接口就是符合REST協(xié)議的腺兴,請(qǐng)注意,這幾個(gè)接口都沒有動(dòng)詞廉侧,只有名詞friends页响,都是通過Http請(qǐng)求的接口類型來判斷是什么業(yè)務(wù)操作。

舉個(gè)反例:generalcode.cn/va/deleteFriends 該接口用來表示刪除朋友伏穆,這就是不符合REST協(xié)議的接口拘泞。

一般接口的返回值是JSON或者XML類型的,筆者在互聯(lián)網(wǎng)的工作經(jīng)驗(yàn)一般都是JSON類型的枕扫。

用HTTP Status Code傳遞Server的狀態(tài)信息陪腌。比如最常用的 200 表示成功,500 表示Server內(nèi)部錯(cuò)誤,403表示Bad Request等诗鸭。(反例:傳統(tǒng)web開發(fā)返回的狀態(tài)碼一律都是200染簇,其實(shí)不可取。)

那這種風(fēng)格的接口有什么好處呢强岸?前后端分離锻弓。前端拿到數(shù)據(jù)只負(fù)責(zé)展示和渲染,不對(duì)數(shù)據(jù)做任何處理蝌箍。后端處理數(shù)據(jù)并以JSON格式傳輸出去青灼,定義這樣一套統(tǒng)一的接口,在web妓盲,ios杂拨,android三端都可以用相同的接口,是不是很爽悯衬?弹沽!

引用:https://blog.csdn.net/qq_21383435/article/details/80032375

引用詳細(xì):https://blog.csdn.net/intelrain/article/details/80449371

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市筋粗,隨后出現(xiàn)的幾起案子策橘,更是在濱河造成了極大的恐慌,老刑警劉巖娜亿,帶你破解...
    沈念sama閱讀 206,378評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件丽已,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡暇唾,警方通過查閱死者的電腦和手機(jī)促脉,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,356評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門辰斋,熙熙樓的掌柜王于貴愁眉苦臉地迎上來策州,“玉大人,你說我怎么就攤上這事宫仗」还遥” “怎么了?”我有些...
    開封第一講書人閱讀 152,702評(píng)論 0 342
  • 文/不壞的土叔 我叫張陵藕夫,是天一觀的道長(zhǎng)孽糖。 經(jīng)常有香客問我,道長(zhǎng)毅贮,這世上最難降的妖魔是什么办悟? 我笑而不...
    開封第一講書人閱讀 55,259評(píng)論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮滩褥,結(jié)果婚禮上病蛉,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好铺然,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,263評(píng)論 5 371
  • 文/花漫 我一把揭開白布俗孝。 她就那樣靜靜地躺著,像睡著了一般魄健。 火紅的嫁衣襯著肌膚如雪赋铝。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,036評(píng)論 1 285
  • 那天沽瘦,我揣著相機(jī)與錄音革骨,去河邊找鬼。 笑死析恋,一個(gè)胖子當(dāng)著我的面吹牛苛蒲,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播绿满,決...
    沈念sama閱讀 38,349評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼臂外,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了喇颁?” 一聲冷哼從身側(cè)響起漏健,我...
    開封第一講書人閱讀 36,979評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎橘霎,沒想到半個(gè)月后蔫浆,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,469評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡姐叁,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,938評(píng)論 2 323
  • 正文 我和宋清朗相戀三年瓦盛,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片外潜。...
    茶點(diǎn)故事閱讀 38,059評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡原环,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出处窥,到底是詐尸還是另有隱情嘱吗,我是刑警寧澤,帶...
    沈念sama閱讀 33,703評(píng)論 4 323
  • 正文 年R本政府宣布滔驾,位于F島的核電站谒麦,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏哆致。R本人自食惡果不足惜绕德,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,257評(píng)論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望摊阀。 院中可真熱鬧耻蛇,春花似錦剩瓶、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,262評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至亡哄,卻和暖如春枝缔,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背蚊惯。 一陣腳步聲響...
    開封第一講書人閱讀 31,485評(píng)論 1 262
  • 我被黑心中介騙來泰國(guó)打工愿卸, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人截型。 一個(gè)月前我還...
    沈念sama閱讀 45,501評(píng)論 2 354
  • 正文 我出身青樓趴荸,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親宦焦。 傳聞我的和親對(duì)象是個(gè)殘疾皇子发钝,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,792評(píng)論 2 345