什么是RESTful?API,有什么作用

更新時(shí)間：2023年11月22日 10:23:35 作者：Evan?Wang

提到RESTful?API大家勢(shì)必或多或少聽(tīng)說(shuō)過(guò),但是什么是RESTful?API?？如何理解RESTful?API?呢？今天咱們就來(lái)聊聊這個(gè)RESTful?API

什么是RESTful API

如何理解RESTful API 呢？請(qǐng)大家耐心讀完這篇文章，相信您讀完后一定會(huì)有一個(gè)更好的理解。

我個(gè)人認(rèn)為，要弄清楚什么是RESTful API,首先要弄清楚什么是REST。

REST 全稱：REpresentational State Transfer，英文翻譯過(guò)來(lái)就是“表現(xiàn)層狀態(tài)轉(zhuǎn)化”。

如果單看這個(gè)概念，估計(jì)大家很難理解。那下面就讓我來(lái)用一句話通俗解釋一下。

RESTful:用URL定位資源、用HTTP動(dòng)詞（GET、POST、PUT、DELETE)描述操作。只要記住這句話也就不難理解了。

Resource：資源，即數(shù)據(jù)。
Representational：某種表現(xiàn)形式，比如用JSON，XML，JPEG等；
State Transfer：狀態(tài)變化。通過(guò)HTTP動(dòng)詞實(shí)現(xiàn)。

名詞解釋

URI（統(tǒng)一資源標(biāo)識(shí)符）：可以唯一標(biāo)識(shí)一個(gè)資源
URL（統(tǒng)一資源定位符）：可以提供找到某個(gè)資源的路徑，比如平時(shí)最常見(jiàn)的網(wǎng)址：

一般一個(gè)URL也是一個(gè)URI，比如上面的網(wǎng)址，即URL可以看做是URI的子集，在圖書(shū)領(lǐng)域中一本書(shū)都有唯一的一個(gè)isbn編號(hào)，這個(gè)編號(hào)其實(shí)也是URI。

RESTful API就是REST風(fēng)格的API，即rest是一種架構(gòu)風(fēng)格，跟編程語(yǔ)言無(wú)關(guān)，跟平臺(tái)無(wú)關(guān)，采用HTTP做傳輸協(xié)議。

那么在什么場(chǎng)景下使用RESTful API呢？在當(dāng)今的互聯(lián)網(wǎng)應(yīng)用的前端展示媒介很豐富。

有手機(jī)、有平板電腦還有PC以及其他的展示媒介，從而你的系統(tǒng)的客戶端要支持瀏覽器、Android、ios等。

此時(shí)你肯定不會(huì)單獨(dú)為每個(gè)客戶端寫(xiě)一個(gè)后臺(tái)系統(tǒng)，而是寫(xiě)一個(gè)后臺(tái)系統(tǒng)提供rest風(fēng)格的URI，這三個(gè)客戶端都請(qǐng)求該同一個(gè)后臺(tái)系統(tǒng)。

那么這些前端接收到的用戶請(qǐng)求統(tǒng)一由一個(gè)后臺(tái)來(lái)處理并返回給不同的前端肯定是最科學(xué)和最經(jīng)濟(jì)的方式如（圖1-1）。

RESTful API就是一套協(xié)議來(lái)規(guī)范多種形式的前端和同一個(gè)后臺(tái)的交互方式。

圖1-1 前后端分離

前后端分離之后，我們就不用在前端頁(yè)面中寫(xiě)jstl，el表達(dá)式了，甚至連jsp都不需要使用了，直接html即可，前端跟后端的交互使用ajax+json這樣符合rest風(fēng)格的架構(gòu)即可，這樣做的好處就是：

項(xiàng)目的分工更加明確了
實(shí)現(xiàn)了前后端的解耦
可以將前端和后端部署到不同的服務(wù)器上來(lái)減輕服務(wù)器的壓力
前后端代碼在不同的服務(wù)器上，可以提高安全性

基于以上的這些因素，rest架構(gòu)的風(fēng)格越來(lái)越流行了。說(shuō)完好處，我們繼續(xù)來(lái)介紹RESTful API。

RESTful API由后臺(tái)也就是SERVER來(lái)提供前端來(lái)調(diào)用。前端調(diào)用API向后臺(tái)發(fā)起HTTP請(qǐng)求，后臺(tái)響應(yīng)請(qǐng)求將處理結(jié)果反饋給前端。也就是說(shuō)RESTful 是典型的基于HTTP的協(xié)議。那么RESTful API有哪些設(shè)計(jì)原則和規(guī)范呢？

1、資源。首先是弄清楚資源的概念。資源就是網(wǎng)絡(luò)上的一個(gè)實(shí)體，一段文本，一張圖片或者一首歌曲。資源總是要通過(guò)一種載體來(lái)反應(yīng)它的內(nèi)容。文本可以用TXT，也可以用HTML或者XML、圖片可以用JPG格式或者PNG格式，JSON是現(xiàn)在最常用的資源表現(xiàn)形式。

2、統(tǒng)一接口。RESTful風(fēng)格的數(shù)據(jù)元操CRUD（create,read,update,delete）分別對(duì)應(yīng)HTTP方法：GET用來(lái)獲取資源，POST用來(lái)新建資源（也可以用于更新資源），PUT用來(lái)更新資源，DELETE用來(lái)刪除資源，這樣就統(tǒng)一了數(shù)據(jù)操作的接口。

3、URI?？梢杂靡粋€(gè)URI（統(tǒng)一資源定位符）指向資源，即每個(gè)URI都對(duì)應(yīng)一個(gè)特定的資源。要獲取這個(gè)資源訪問(wèn)它的URI就可以，因此URI就成了每一個(gè)資源的地址或識(shí)別符。一般的，每個(gè)資源至少有一個(gè)URI與之對(duì)應(yīng)，最典型的URI就是URL。

4、無(wú)狀態(tài)。所謂無(wú)狀態(tài)即所有的資源都可以URI定位，而且這個(gè)定位與其他資源無(wú)關(guān)，也不會(huì)因?yàn)槠渌Y源的變化而變化。有狀態(tài)和無(wú)狀態(tài)的區(qū)別，舉個(gè)例子說(shuō)明一下，例如要查詢員工工資的步驟為第一步：登錄系統(tǒng)。第二步：進(jìn)入查詢工資的頁(yè)面。第三步：搜索該員工。第四步：點(diǎn)擊姓名查看工資。這樣的操作流程就是有狀態(tài)的，查詢工資的每一個(gè)步驟都依賴于前一個(gè)步驟，只要前置操作不成功，后續(xù)操作就無(wú)法執(zhí)行。如果輸入一個(gè)URL就可以得到指定員工的工資，則這種情況就是無(wú)狀態(tài)的，因?yàn)楂@取工資不依賴于其他資源或狀態(tài)，且這種情況下，員工工資是一個(gè)資源，由一個(gè)URL與之對(duì)應(yīng)可以通過(guò)HTTP中的GET方法得到資源，這就是典型的RESTful風(fēng)格。

說(shuō)了這么多，到底R(shí)ESTful長(zhǎng)什么樣子的呢？

下面我們舉一些例子。

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的用戶新增好友。其他的操作類似就不舉例了。

還是回顧我們最開(kāi)始說(shuō)到的那句話，即用URL定位資源、用HTTP動(dòng)詞（GET,POST,PUT,DELETE)描述操作。

在rest中會(huì)通過(guò)向服務(wù)器提交的請(qǐng)求類型來(lái)表示增刪改查這些操作

GET（SELECT）：從服務(wù)器取出資源。
POST（CREATE）：在服務(wù)器新建一個(gè)資源。
PUT（UPDATE）：在服務(wù)器更新資源。
DELETE（DELETE）：從服務(wù)器刪除資源。

RESTful API還有其他一些規(guī)范

①、應(yīng)該將API的版本號(hào)放入U(xiǎn)RL。GET:http://www.xxx.com/v1/friend/123。或者將版本號(hào)放在HTTP頭信息中。我個(gè)人覺(jué)得要不要版本號(hào)取決于自己開(kāi)發(fā)團(tuán)隊(duì)的習(xí)慣和業(yè)務(wù)的需要，不是強(qiáng)制的。

②、URL中只能有名詞而不能有動(dòng)詞，操作的表達(dá)是使用HTTP的動(dòng)詞GET,POST,PUT,DELETEL。URL只標(biāo)識(shí)資源的地址，既然是資源那就是名詞了。

③、如果記錄數(shù)量很多，服務(wù)器不可能都將它們返回給用戶。API應(yīng)該提供參數(shù)，過(guò)濾返回結(jié)果。?limit=10：指定返回記錄的數(shù)量、?page=2&per_page=100：指定第幾頁(yè)，以及每頁(yè)的記錄數(shù)。