restful風(fēng)格接口相關(guān)總結(jié)

有關(guān)restful概念請(qǐng)看阮一峰的文章,http://www.ruanyifeng.com/blog/2014/05/restful_api.html
這里總結(jié)一下:
什么是RESTful架構(gòu):
(1)每一個(gè)URI代表一種資源;
(2)客戶端和服務(wù)器之間,傳遞這種資源的某種表現(xiàn)層;
(3)客戶端通過(guò)四個(gè)HTTP動(dòng)詞,對(duì)服務(wù)器端資源進(jìn)行操作,實(shí)現(xiàn)"表現(xiàn)層狀態(tài)轉(zhuǎn)化"。
HTTP動(dòng)詞:
GET(SELECT):從服務(wù)器取出資源(一項(xiàng)或多項(xiàng))。
POST(CREATE):在服務(wù)器新建一個(gè)資源。
PUT(UPDATE):在服務(wù)器更新資源(客戶端提供改變后的完整資源)。
PATCH(UPDATE):在服務(wù)器更新資源(客戶端提供改變的屬性),這個(gè)很少用。
DELETE(DELETE):從服務(wù)器刪除資源。

HTTP 狀態(tài)代碼 (這里是參考RESTful API 設(shè)計(jì)最佳實(shí)踐,http://www.oschina.net/translate/best-practices-for-a-pragmatic-restful-api?lang=chs&page=4#
HTTP定義了一套可以從API返回的有意義的狀態(tài)代碼。 這些代碼能夠用來(lái)幫助API使用者對(duì)不同的響應(yīng)做出相應(yīng)處理。我已經(jīng)把你必然會(huì)用到的那些列成了一個(gè)簡(jiǎn)短的清單:
200 OK (成功) - 對(duì)一次成功的GET, PUT, PATCH 或 DELETE的響應(yīng)。也能夠用于一次未產(chǎn)生創(chuàng)建活動(dòng)的POST
201 Created (已創(chuàng)建) - 對(duì)一次導(dǎo)致創(chuàng)建活動(dòng)的POST的響應(yīng)。 同時(shí)結(jié)合使用一個(gè)位置頭信息指向新資源的位置- Response to a POST that results in a creation. Should be combined with a Location header pointing to the location of the new resource
204 No Content (沒(méi)有內(nèi)容) - 對(duì)一次沒(méi)有返回主體信息(像一次DELETE請(qǐng)求)的請(qǐng)求的響應(yīng)
304 Not Modified (未修改) - 當(dāng)使用HTTP緩存頭信息時(shí)使用304
400 Bad Request (錯(cuò)誤的請(qǐng)求) - 請(qǐng)求是畸形的, 比如無(wú)法解析請(qǐng)求體
401 Unauthorized (未授權(quán)) - 當(dāng)沒(méi)有提供或提供了無(wú)效認(rèn)證細(xì)節(jié)時(shí)。如果從瀏覽器使用API,也可以用來(lái)觸發(fā)彈出一次認(rèn)證請(qǐng)求
403 Forbidden (禁止訪問(wèn)) - 當(dāng)認(rèn)證成功但是認(rèn)證用戶無(wú)權(quán)訪問(wèn)該資源時(shí)
404 Not Found (未找到) - 當(dāng)一個(gè)不存在的資源被請(qǐng)求時(shí)
405 Method Not Allowed (方法被禁止) - 當(dāng)一個(gè)對(duì)認(rèn)證用戶禁止的HTTP方法被請(qǐng)求時(shí)
410 Gone (已刪除) - 表示資源在終端不再可用。當(dāng)訪問(wèn)老版本API時(shí),作為一個(gè)通用響應(yīng)很有用
415 Unsupported Media Type (不支持的媒體類型) - 如果請(qǐng)求中包含了不正確的內(nèi)容類型
422 Unprocessable Entity (無(wú)法處理的實(shí)體) - 出現(xiàn)驗(yàn)證錯(cuò)誤時(shí)使用
429 Too Many Requests (請(qǐng)求過(guò)多) - 當(dāng)請(qǐng)求由于訪問(wèn)速率限制而被拒絕時(shí)

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • Spring Cloud為開(kāi)發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見(jiàn)模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 136,569評(píng)論 19 139
  • API定義規(guī)范 本規(guī)范設(shè)計(jì)基于如下使用場(chǎng)景: 請(qǐng)求頻率不是非常高:如果產(chǎn)品的使用周期內(nèi)請(qǐng)求頻率非常高,建議使用雙通...
    有涯逐無(wú)涯閱讀 2,928評(píng)論 0 6
  • 一說(shuō)到REST,我想大家的第一反應(yīng)就是“啊,就是那種前后臺(tái)通信方式?!钡窃谝笤敿?xì)講述它所提出的各個(gè)約束,以及如...
    時(shí)待吾閱讀 3,600評(píng)論 0 19
  • 譯者:知秋(極樂(lè)科技專欄作者)來(lái)源:https://zhuanlan.zhihu.com/p/24592119 當(dāng)...
    極樂(lè)君閱讀 1,321評(píng)論 0 14
  • 上周給媽媽打電話,一直在我家養(yǎng)病的姥姥回老家了。姥姥前腳剛走,媽媽后腳就去了醫(yī)院,原來(lái)她頭疼心悸已很久,硬撐了小半...
    團(tuán)鐵鐵閱讀 12,216評(píng)論 224 663

友情鏈接更多精彩內(nèi)容