REST全稱是Representational State Transfer，中文意思是表述性狀態(tài)轉(zhuǎn)移。不管是英文還是中文解釋，都難得其意！
那究竟指的是什么的表述? 其實指的就是資源。任何事物，只要有被引用到的必要，它就是一個資源。要讓一個資源可以被識別，需要有個唯一標識，在Web中這個唯一標識就是URI(Uniform Resource Identifier)，標識的資源可能是服務器上的一個文件，不過，也可能是一個郵件地址、新聞消息、圖書、人名、Internet主機或者任何其它內(nèi)容。URI既可以看成是資源的地址，也可以看成是資源的名稱，它包含URL和URN。
- URL = Universal Resource Locator 統(tǒng)一資源定位符
URL唯一地標識一個資源在Internet上的位置。不管用什么方法表示，只要能定位一個資源，就叫URL。 - URN = Universal Resource Name 統(tǒng)一資源名稱
URN它命名資源但不指定如何定位資源，比如：只告訴你一個人的姓名，不告訴你這個人在哪。
一、URL 設計
RESTful 的核心思想就是，客戶端發(fā)出的數(shù)據(jù)操作指令都是"動詞 + 賓語"的結(jié)構(gòu)。簡單來說就是URL定位資源，用HTTP動詞描述操作。
比如用GET來表示讀取，POST表示新建，PUT表示更新，PATCH表示更新，但通常是部分更新，DELETE表示刪除。
1.賓語必須是名詞
賓語就是 API 的 URL，是 HTTP 動詞作用的對象。它應該是名詞，不能是動詞。
GET /article
2.復數(shù) URL
沒有統(tǒng)一的規(guī)定，但是常見的操作是當要讀取一個集合要用復數(shù)形式。
GET /articles
3.避免多級 URL
當資源需要多級分類時，比較好的做法是，除了第一級，其他級別都用查詢字符串表達。這種URL不僅利于擴展，語義也更加明確。
GET /articles?published=true
二、狀態(tài)碼
狀態(tài)碼表示必須明確
通常來說：1xx表示相關(guān)信息，2xx表示操作成功，3xx表示重定向，4xx表示客戶端錯誤，5xx表示服務器錯誤。RESTful就要求將這五類按不同請求方式進行細分。
以GET為例
200（OK）——表示已在響應中發(fā)出
204（無內(nèi)容） —— 資源有空表示
301（Moved Permanently） —— 資源的URI已被更新
303（See Other） —— 其他（如，負載均衡）
304（not modified）—— 資源未更改（緩存）
400 （bad request）—— 指代壞請求（如，參數(shù)錯誤）
404 （not found）—— 資源不存在
406 （not acceptable）—— 服務端不支持所需表示
500 （internal server error）—— 通用錯誤響應
503 （Service Unavailable）—— 服務端當前無法處理請求
三、服務器回應
1.不要返回純本文
API 返回的數(shù)據(jù)格式，不應該是純文本，而應該是一個 JSON 對象，因為這樣才能返回標準的結(jié)構(gòu)化數(shù)據(jù)。所以，服務器回應的 HTTP 頭的Content-Type屬性要設為application/json。
客戶端請求時，也要明確告訴服務器，可以接受 JSON 格式，即請求的 HTTP 頭的ACCEPT屬性也要設成application/json。
2.發(fā)生錯誤時，不要返回 200 狀態(tài)碼
狀態(tài)碼反映發(fā)生的錯誤，并將具體的錯誤信息放在數(shù)據(jù)體里面返回。在發(fā)生錯誤時也返回200狀態(tài)碼，這種做法是不恰當?shù)摹?/p>
3.提供鏈接
在回應中，給出相關(guān)鏈接，便于下一步操作。這樣的話，用戶只要記住一個 URL，就可以發(fā)現(xiàn)其他的 URL。這種方法叫做 HATEOAS。
HATEOAS(Hypermedia as the engine of application state)，超媒體即應用狀態(tài)引擎。它是REST架構(gòu)的主要約束。“hepermedia”表示任何包含指向圖片、電影、文字等資源的鏈接，Web是超媒體的經(jīng)典例子。HATEOAS背后的思想其實非常簡單，就是響應中包含指向其它資源的鏈接?？蛻舳丝梢岳眠@些鏈接和服務器交互。
超媒體是什么?
當你瀏覽Web網(wǎng)頁時，從一個連接跳到一個頁面，再從另一個連接跳到另外一個頁面，就是利用了超媒體的概念：把一個個把資源鏈接起來。
要達到這個目的，就要求在表述格式里邊加入鏈接來引導客戶端。在《RESTful Web Services》一書中，作者把這種具有鏈接的特性成為連通性。
這一特性應用特別廣泛，比如創(chuàng)建訂單后通過鏈接引導客戶端如何去付款。
————愿你在迷茫時，堅信你的珍貴，愛你所愛，行你所行，聽從你心，無問西東。
