restful風格接口相關總結

有關restful概念請看阮一峰的文章联贩,http://www.ruanyifeng.com/blog/2014/05/restful_api.html
這里總結一下:
什么是RESTful架構:
(1)每一個URI代表一種資源捎拯;
(2)客戶端和服務器之間,傳遞這種資源的某種表現(xiàn)層署照;
(3)客戶端通過四個HTTP動詞,對服務器端資源進行操作没隘,實現(xiàn)"表現(xiàn)層狀態(tài)轉化"禁荸。
HTTP動詞:
GET(SELECT):從服務器取出資源(一項或多項)。
POST(CREATE):在服務器新建一個資源屡限。
PUT(UPDATE):在服務器更新資源(客戶端提供改變后的完整資源)。
PATCH(UPDATE):在服務器更新資源(客戶端提供改變的屬性),這個很少用罩旋。
DELETE(DELETE):從服務器刪除資源。

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

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市孙乖,隨后出現(xiàn)的幾起案子份氧,更是在濱河造成了極大的恐慌唯袄,老刑警劉巖蜗帜,帶你破解...
    沈念sama閱讀 206,311評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件厅缺,死亡現(xiàn)場離奇詭異,居然都是意外死亡湘捎,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,339評論 2 382
  • 文/潘曉璐 我一進店門舷胜,熙熙樓的掌柜王于貴愁眉苦臉地迎上來活翩,“玉大人,你說我怎么就攤上這事材泄。” “怎么了峦树?”我有些...
    開封第一講書人閱讀 152,671評論 0 342
  • 文/不壞的土叔 我叫張陵,是天一觀的道長魁巩。 經(jīng)常有香客問我,道長化戳,這世上最難降的妖魔是什么埋凯? 我笑而不...
    開封第一講書人閱讀 55,252評論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮白对,結果婚禮上,老公的妹妹穿的比我還像新娘蟀瞧。我一直安慰自己条摸,他們只是感情好,可當我...
    茶點故事閱讀 64,253評論 5 371
  • 文/花漫 我一把揭開白布钉蒲。 她就那樣靜靜地躺著,像睡著了一般踏枣。 火紅的嫁衣襯著肌膚如雪钙蒙。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,031評論 1 285
  • 那天躬厌,我揣著相機與錄音,去河邊找鬼偏陪。 笑死煮嫌,一個胖子當著我的面吹牛抱虐,可吹牛的內容都是我干的昌阿。 我是一名探鬼主播,決...
    沈念sama閱讀 38,340評論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼灶轰,長吁一口氣:“原來是場噩夢啊……” “哼刷钢!你這毒婦竟也來了?” 一聲冷哼從身側響起内地,我...
    開封第一講書人閱讀 36,973評論 0 259
  • 序言:老撾萬榮一對情侶失蹤阱缓,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后荆针,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,466評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡喉悴,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 35,937評論 2 323
  • 正文 我和宋清朗相戀三年玖媚,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片最盅。...
    茶點故事閱讀 38,039評論 1 333
  • 序言:一個原本活蹦亂跳的男人離奇死亡涡贱,死狀恐怖咏删,靈堂內的尸體忽然破棺而出问词,到底是詐尸還是另有隱情,我是刑警寧澤辰狡,帶...
    沈念sama閱讀 33,701評論 4 323
  • 正文 年R本政府宣布垄分,位于F島的核電站,受9級特大地震影響薄湿,放射性物質發(fā)生泄漏偷卧。R本人自食惡果不足惜吆倦,卻給世界環(huán)境...
    茶點故事閱讀 39,254評論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望蚕泽。 院中可真熱鬧,春花似錦仔蝌、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,259評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至动知,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間鸵鸥,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,485評論 1 262
  • 我被黑心中介騙來泰國打工妒穴, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留摊崭,地道東北人。 一個月前我還...
    沈念sama閱讀 45,497評論 2 354
  • 正文 我出身青樓矮台,卻偏偏與公主長得像根时,于是被迫代替她去往敵國和親瘦赫。 傳聞我的和親對象是個殘疾皇子蛤迎,可洞房花燭夜當晚...
    茶點故事閱讀 42,786評論 2 345

推薦閱讀更多精彩內容

  • Spring Cloud為開發(fā)人員提供了快速構建分布式系統(tǒng)中一些常見模式的工具(例如配置管理替裆,服務發(fā)現(xiàn)唱较,斷路器扎唾,智...
    卡卡羅2017閱讀 134,599評論 18 139
  • API定義規(guī)范 本規(guī)范設計基于如下使用場景: 請求頻率不是非常高:如果產(chǎn)品的使用周期內請求頻率非常高胸遇,建議使用雙通...
    有涯逐無涯閱讀 2,519評論 0 6
  • 一說到REST,我想大家的第一反應就是“啊纸镊,就是那種前后臺通信方式《和”但是在要求詳細講述它所提出的各個約束,以及如...
    時待吾閱讀 3,410評論 0 19
  • 譯者:知秋(極樂科技專欄作者)來源:https://zhuanlan.zhihu.com/p/24592119 當...
    極樂君閱讀 1,190評論 0 14
  • 上周給媽媽打電話,一直在我家養(yǎng)病的姥姥回老家了罐呼。姥姥前腳剛走,媽媽后腳就去了醫(yī)院嫉柴,原來她頭疼心悸已很久,硬撐了小半...
    團鐵鐵閱讀 12,052評論 224 664