什麼是RESTful API

要弄清楚什麼是RESTful API,首先要弄清楚什麼是REST。REST -- REpresentational State Transfer，英語的直譯就是「表現層狀態轉移」。若是看這個概念，估計沒幾我的能明白是什麼意思。那下面就讓我來用一句人話解釋一下什麼是RESTful:URL定位資源，用HTTP動詞（GET,POST,PUT,DELETE)描述操做。

 

     Resource：資源，即數據。
     Representational：某種表現形式，好比用JSON，XML，JPEG等；
     State Transfer：狀態變化。經過HTTP動詞實現。

 

    因此RESTful API就是REST風格的API。 那麼在什麼場景下使用RESTful API呢？在當今的互聯網應用的前端展現媒介很豐富。有手機、有平板電腦還有PC以及其餘的展現媒介。那麼這些前端接收到的用戶請求統一由一個後臺來處理並返回給不一樣的前端確定是最科學和最經濟的方式，RESTful API就是一套協議來規範多種形式的前端和同一個後臺的交互方式。

 

     RESTful API由後臺也就是SERVER來提供前端來調用。前端調用API向後臺發起HTTP請求，後臺響應請求將處理結果反饋給前端。也就是說RESTful 是典型的基於HTTP的協議。那麼RESTful API有哪些設計原則和規範呢？

 

     1，資源。首先是弄清楚資源的概念。資源就是網絡上的一個實體，一段文本，一張圖片或者一首歌曲。資源老是要經過一種載體來反應它的內容。文本能夠用TXT，也能夠用HTML或者XML、圖片能夠用JPG格式或者PNG格式，JSON是如今最經常使用的資源表現形式。

 

     2，統一接口。RESTful風格的數據元操CRUD（create,read,update,delete）分別對應HTTP方法：GET用來獲取資源，POST用來新建資源（也能夠用於更新資源），PUT用來更新資源，DELETE用來刪除資源，這樣就統一了數據操做的接口。

 

     3，URI。能夠用一個URI（統一資源定位符）指向資源，即每一個URI都對應一個特定的資源。要獲取這個資源訪問它的URI就能夠，所以URI就成了每個資源的地址或識別符。通常的，每一個資源至少有一個URI與之對應，最典型的URI就是URL。

 

     4，無狀態。所謂無狀態即全部的資源均可以URI定位，並且這個定位與其餘資源無關，也不會由於其餘資源的變化而變化。有狀態和無狀態的區別，舉個例子說明一下，例如要查詢員工工資的步驟爲第一步：登陸系統。第二步：進入查詢工資的頁面。第三步：搜索該員工。第四步：點擊姓名查看工資。這樣的操做流程就是有狀態的，查詢工資的每個步驟都依賴於前一個步驟，只要前置操做不成功，後續操做就沒法執行。若是輸入一個URL就能夠獲得指定員工的工資，則這種狀況就是無狀態的，由於獲取工資不依賴於其餘資源或狀態，且這種狀況下，員工工資是一個資源，由一個URL與之對應能夠經過HTTP中的GET方法獲得資源，這就是典型的RESTful風格。

 

     說了這麼多，到底RESTful長什麼樣子的呢？

GET:http://www.xxx.com/source/id 獲取指定ID的某一類資源。例如GET:http://www.xxx.com/friends/123表示獲取ID爲123的會員的好友列表。若是不加id就表示獲取全部會員的好友列表。

POST:http://www.xxx.com/friends/123表示爲指定ID爲123的會員新增好友。其餘的操做相似就不舉例了。

 

     RESTful API還有其餘一些規範。1：應該將API的版本號放入URL。GET:http://www.xxx.com/v1/friend/123。或者將版本號放在HTTP頭信息中。我我的以爲要不要版本號取決於本身開發團隊的習慣和業務的須要，不是強制的。2：URL中只能有名詞而不能有動詞，操做的表達是使用HTTP的動詞GET,POST,PUT,DELETEL。URL只標識資源的地址，既然是資源那就是名詞了。3：若是記錄數量不少，服務器不可能都將它們返回給用戶。API應該提供參數，過濾返回結果。?limit=10：指定返回記錄的數量、?page=2&per_page=100：指定第幾頁，以及每頁的記錄數。--------------------- 做者：hjc1984117 來源：CSDN 原文：https://blog.csdn.net/hjc1984117/article/details/77334616?utm_source=copy 版權聲明：本文爲博主原創文章，轉載請附上博文連接！