Restful規範-開發api接口

web服務交互

咱們在瀏覽器中能看到的每一個網站，都是一個web服務。那麼咱們在提供每一個web服務的時候，

　　都須要先後端交互，先後端交互就必定有一些實現方案，咱們一般叫web服務交互方案。

　　目前主流的三種web服務交互方案：

　　　　-- REST （ Representational State Transfer）表述性狀態轉移

　　　　-- SOAP （Simple Object Access Protocol） 簡單的對象訪問協議

　　　　-- XML-RPC （XML Remote Procedure Call）基於XML的遠程過程調用

　　XML-RPC是經過XML將調用函數封裝，並使用HTTP協議做爲傳送機制。

　　後來在新的功能不斷被引入下，這個標準慢慢演變成爲今日的SOAP協定。

　　SOAP服務則是以自己所定義的操做集，來訪問網絡上的資源。

　　SOAP也是基於XML的，可是它不僅限於HTTP協議的傳輸，包括TCP協議，UDP協議均可以傳輸。

　　REST是Roy Thomas Fielding博士於2000年在他的博士論文裏提出來的。

　　REST相比SOAP更加簡潔，性能和開發效率也有突出的優點。

　　咱們今天主要說一下這個REST，如今愈來愈多的web服務開始採用REST風格設計和實現。

　　例如，amazon.com提供接近REST風格的Web服務進行圖書查找；雅虎提供的Web服務也是REST風格的。

　　咱們接下來要學的框架也是遵循REST風格的，那麼咱們來看下它究竟是個什麼樣的風格，

　　瞭解了它是什麼後，咱們看下它的優勢是什麼，咱們爲何用它。

理解REST

若是咱們想要理解restful，就要理解Representational State Transfer這個詞組的意思，表徵性狀態轉移。

　　這裏所說的表徵性，其實指的就是資源。一般咱們稱爲資源狀態轉移。

什麼是資源

　　任何事物，只要有被引用到的必要，它就是一個資源。

　　咱們在瀏覽器中看到的文本，視頻，圖片等等都是資源。這些都是實實在在存在的實體。

　　資源能夠是一個實體，也能夠是抽象概念。

　　好比說吧：

　　　　-- 李傑的我的信息

　　　　-- 李軍的手機號

　　　　-- 李傑跟李軍的潛在關係

　　這些都是資源，能夠是實體好比我的信息，手機號。也能夠是抽象的概念，好比兩我的的關係......

　　那麼在咱們的網絡中，咱們要引用資源，資源必定要有一個標識，在web中的惟一標識就是URI，

　　URI咱們不常據說，咱們常常用URL，那麼二者區別是什麼呢~

什麼是URI，URL

　　URI 統一資源標誌符。

　　URL 統一資源定位符。

　　URI是給咱們的資源進行標識的，URL是描述咱們資源地址的。

　　好比說咱們每一個人都有名字和身份證，名字可能重名，可是身份證是惟一的，

　　那麼身份證號就能夠是咱們的URI，標識咱們每一個人，也能夠說標識咱們每一個資源。

　　咱們能夠經過身份證號找到Alex，也能夠經過下面這種方式找到他.....

　　Alex的住址協議://地球/中國/屌絲省/屌絲市/寡婦村/250號街道/250號/Alex

　　這個就是咱們的URL，咱們經過這兩種方式均可以找到咱們的資源，

　　其實咱們的URL能夠說是URI的子集，經過定位的方式實現的URI。

　　這是咱們資源的定位有了資源的地址後，咱們要去訪問資源，那麼咱們要經過什麼方式去訪問呢

統一資源接口

　　如今咱們能夠經過URL去訪問到資源，那麼咱們對資源會有不少不一樣的操做，增刪改查，

　　之前咱們可能會爲了這個增長新設計一個URL，而後這個URL就是對數據進行增長的，

　　還會爲了更新和刪除分別設計一個URL，如今咱們不用了，咱們只有一個URL，

　　而後根據HTTP請求方式的不一樣，對資源進行不一樣的操做，這個就是是統一資源接口。

　　咱們必定要遵循HTTP請求方法的語義，也就是說POST請求就在新增數據等....

資源的表述

　　資源的表述其實就是資源的展示形式，咱們客戶端和服務端傳輸的都是資源的表述，而不是資源自己。

　　例如文本資源能夠採用html、xml、json等格式，圖片可使用PNG或JPG展示出來。

　　那麼客戶端如何知道服務端提供哪一種表述形式呢?

　　能夠經過HTTP內容協商，客戶端能夠經過Accept頭請求一種特定格式的表述，服務端則經過Content-Type告訴客戶端資源的表述形式。

　　這些資源的表述呈如今頁面上，就是咱們說的資源狀態。

狀態轉移

　　咱們在看頁面的時候，從當前資源的表述(也能夠說狀態或者表現層)會跳轉到其餘的資源狀態。

　　服務端經過超媒體告訴客戶端當前狀態有哪些後續狀態能夠進入。

　　這些相似"下一頁"之類的連接起的就是這種推動狀態的做用——指引你如何從當前狀態進入下一個可能的狀態。

總結　

　　能夠得知REST風格的特色以下：

　　（1）在web中，只要有被引用的必要都叫資源。

　　（2）每一個URI表明一個資源，獨一無二的。

　　（3）客戶端經過HTTP的方法，對服務器端資源進行操做；

　　（4）客戶端和服務器之間，傳遞這種資源的某種表現層；

　　（5）經過超連接的指引，實現"表現層狀態轉移"。

RESTful

　
　　若是一個架構符合REST的約束條件和原則，咱們就稱它爲RESTful架構。

　　一種軟件的架構風格，設計風格, 爲客戶端和服務端的交互提供一組設計原則和約束條件。

restful規範

一 面向資源編程
　　每一個URL表明一種資源，URL中儘可能不要用動詞，要用名詞。

二 根據method不一樣，進行不一樣的操做
　　GET/POST/PUT/DELETE/PATCH

三 在URL中體現版本
　　https://www.bootcss.com/v1/mycss

　　https://v1.bootcss.com/mycss

四 在URL中體現是不是API
　　https://www.bootcss.com/api/mycss

　　https://api.bootcss.com/mycss

五 在URL中的過濾條件
　　https://www.bootcss.com/v1/mycss？page=3

六 儘可能使用HTTPS
　　https://www.bootcss.com/v1/mycss

七 響應時設置狀態碼
　　1** 信息，服務器收到請求，須要請求者繼續執行操做

　　2** 成功，操做被成功接收並處理

　　3** 重定向，須要進一步的操做以完成請求

　　4** 客戶端錯誤，請求包含語法錯誤或沒法完成請求

　　5** 服務器錯誤，服務器在處理請求的過程當中發生了錯誤

八 返回值
　　GET請求 返回查到全部或單條數據

　　POST請求 返回新增的數據

　　PUT請求 返回更新數據

　　PATCH請求 局部更新 返回更新整條數據

　　DELETE請求 返回值爲空

九 返回錯誤信息
　　返回值攜帶錯誤信息

十 Hypermedia API
　　若是遇到須要跳轉的狀況 攜帶調轉接口的URL

　　ret = {
code: 1000,
data:{
id:1,
name:'小強',
depart_id:http://addmoney.top/api/v1/depart/8/ } }