團隊之間協作有很多的介面規範，團隊做大了,平台之間的資料傳輸的規範需要定義好。需要有乙個閥，restful 就是這樣的乙個規範，我們都應該遵守這樣的乙個規範。
越來越多的人意識到，**即軟體，而且是一種新型的軟體
**開發，完全可以採用軟體開發的模式。但是傳統上，軟體和網路是兩個不同的領域，網際網路的興起讓這2個領域開始融合
resful架構，是目前最流行的一種網際網路軟體架構，它結構清晰、符合標準、易於理解、擴充套件方便。所以正得到越來越多**的採用
http是乙個無狀態協議，這意味著狀態都儲存在了伺服器端，因此，如果客戶端想要操作伺服器，必須通過某種手段，讓伺服器端狀態發生「狀態轉化」
什麼是restful架構：
1.每乙個uri代表一種資源
2.客戶端和伺服器之間，傳遞這種資源的表現層
3.客戶端通過htttp動詞，對伺服器端資源進行操作，實現「表現層狀態轉化」。
****
一、協議
api與使用者的通訊協議，總是使用https協議。
二、網域名稱
應該盡量將api部署在專用網域名稱之下。
如果確定api很簡單，不會有進一步擴充套件，可以考慮放在主網域名稱下。
三、版本（versioning）
應該將api的版本號放入url。
/v1/
另一種做法是，將版本號放在http頭資訊中，但不如放入url方便和直觀。github採用這種做法。
四、路徑（endpoint）
路徑又稱"終點"（endpoint），表示api的具體**。
在restful架構中，每個**代表一種資源（resource），所以**中不能有動詞，只能有名詞，而且所用的名詞往往與資料庫的**名對應。一般來說，資料庫中的表都是同種記錄的"集合"（collection），所以api中的名詞也應該使用複數。
舉例來說，有乙個api提供動物園（zoo）的資訊，還包括各種動物和雇員的資訊，則它的路徑應該設計成下面這樣。
/v1/zoos
/v1/animals
/v1/employees
如果記錄數量很多，伺服器不可能都將它們返回給使用者。api應該提供引數，過濾返回結果。
下面是一些常見的引數。
?limit=10：指定返回記錄的數量
?offset=10：指定返回記錄的開始位置。
?page=2&per_page=100：指定第幾頁，以及每頁的記錄數。
?sortby=name&order=asc：指定返回結果按照哪個屬性排序，以及排序順序。
?animal_type_id=1：指定篩選條件
七、狀態碼（status codes）
伺服器向使用者返回的狀態碼和提示資訊，常見的有以下一些（方括號中是該狀態碼對應的http動詞）。
200 ok - [get]：伺服器成功返回使用者請求的資料，該操作是冪等的（idempotent）。
201 created - [post/put/patch]：使用者新建或修改資料成功。
202 accepted - [*]：表示乙個請求已經進入後台排隊（非同步任務）
204 no content - [delete]：使用者刪除資料成功。
400 invalid request - [post/put/patch]：使用者發出的請求有錯誤，伺服器沒有進行新建或修改資料的操作，該操作是冪等的。
401 unauthorized - [*]：表示使用者沒有許可權（令牌、使用者名稱、密碼錯誤）。
403 forbidden - [*] 表示使用者得到授權（與401錯誤相對），但是訪問是被禁止的。
404 not found - [*]：使用者發出的請求針對的是不存在的記錄，伺服器沒有進行操作，該操作是冪等的。
406 not acceptable - [get]：使用者請求的格式不可得（比如使用者請求json格式，但是只有xml格式）。
410 gone -[get]：使用者請求的資源被永久刪除，且不會再得到的。
422 unprocesable entity - [post/put/patch] 當建立乙個物件時，發生乙個驗證錯誤。
500 internal server error - [*]：伺服器發生錯誤，使用者將無法判斷發出的請求是否成功。
八、錯誤處理（error handling）
如果狀態碼是4xx，就應該向使用者返回出錯資訊。一般來說，返回的資訊中將error作為鍵名，出錯資訊作為鍵值即可。
針對不同操作，伺服器向使用者返回的結果應該符合以下規範。
get /collection：返回資源物件的列表（陣列）
get /collection/resource：返回單個資源物件
post /collection：返回新生成的資源物件
put /collection/resource：返回完整的資源物件
patch /collection/resource：返回完整的資源物件
delete /collection/resource：返回乙個空文件
restful api最好做到hypermedia，即返回結果中提供鏈結，連向其他api方法，使得使用者不查文件，也知道下一步應該做什麼。
比如，當使用者向api.example.com的根目錄發出請求，會得到這樣乙個文件。
}hypermedia api的設計被稱為hateoas。github的api就是這種設計，訪問api.github.com會得到乙個所有可用api的**列表。
十一、其他
（1）api的身份認證應該使用oauth 2.0框架。
（2）伺服器返回的資料格式，應該盡量使用json，避免使用xml。
restFul介紹及其使用規範
什麼是rest和restful api？rest 英文 representational state transfer，簡稱rest 表徵性狀態轉移，是一種軟體架構風格。restful restful api就是rest風格的api restful規範 1 建議使用https作為網路通訊協議 2 介...
restful介面規範
資源 resource 任何東西都是一種資源，例如，一篇部落格文章 表示 representation 資源的一種表現形式，例如，json xml url 每個資源都應該有乙個對應的url uri url是uri的一種，url都有對應的資源，而uri不一定，它強調的是一種資源標識 get 獲得乙個資...
RESTful格式規範
restful是介面開發格式裡面很重要的乙個山頭，基本開發介面都需要遵守這個規範，它共有十條規範格式 1 網域名稱，一般將api放在組網域名稱下 3 路徑，路徑表示api的具體 代表一種資源，中不能使用動詞，只能使用名詞，而其必須是複數 4 使用標準的http方法，由http動詞組成 get sel...