有關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 (請求過多) - 當請求由于訪問速率限制而被拒絕時