1.安全保障:https傳輸
2.特徵表現:一看便知,用api關鍵字標識介面url
- [
-
3.多版共存:不同版本介面可以同時存在
-
-
4.資料即資源:傳輸的資料可以看作真正的資源存在,介面以名詞的形式存在
-
-
5.請求方式決定操作方式:不同的請求方式,對於資料的操作方式不同
- - get請求:獲取資料
- /1 - get請求:獲取資料
- - post請求:增加資料
- /1 - put請求:修改資料(整體)
- /1 - patch請求:修改資料(區域性)
- /1 - delete請求:刪除資料
6.資料過濾表現於url上:通過在url上傳參的形式傳遞搜尋條件
- 指定返回記錄的數量
- 指定返回記錄的開始位置
7.響應狀態碼:不同的狀態嗎代表響應的不同
應狀態碼2xx
- 200:常規請求
- 201:建立成功
7.2 重定向響應
- 響應狀態碼3xx
- 301:永久重定向
- 302:暫時重定向
7.3 客戶端異常
- 響應狀態碼4xx
- 403:請求無許可權
- 404:請求路徑不存在
- 405:請求方法不存在
7.4 伺服器異常
- 響應狀態碼5xx
- 500:伺服器異常
8.錯誤處理:對於錯誤要給予提示資訊
9.返回結果:針對不同操作,伺服器向使用者返回的結果應該符合以下規範
get /collection:返回資源物件的列表(陣列)
get /collection/resource:返回單個資源物件
post /collection:返回新生成的資源物件
put /collection/resource:返回完整的資源物件
patch /collection/resource:返回完整的資源物件
delete /collection/resource:返回乙個空文件
...]
}
restful介面規範
資源 resource 任何東西都是一種資源,例如,一篇部落格文章 表示 representation 資源的一種表現形式,例如,json xml url 每個資源都應該有乙個對應的url uri url是uri的一種,url都有對應的資源,而uri不一定,它強調的是一種資源標識 get 獲得乙個資...
restful規範介紹
團隊之間協作有很多的介面規範,團隊做大了,平台之間的資料傳輸的規範需要定義好。需要有乙個閥,restful 就是這樣的乙個規範,我們都應該遵守這樣的乙個規範。越來越多的人意識到,即軟體,而且是一種新型的軟體 開發,完全可以採用軟體開發的模式。但是傳統上,軟體和網路是兩個不同的領域,網際網路的興起讓這...
RESTful格式規範
restful是介面開發格式裡面很重要的乙個山頭,基本開發介面都需要遵守這個規範,它共有十條規範格式 1 網域名稱,一般將api放在組網域名稱下 3 路徑,路徑表示api的具體 代表一種資源,中不能使用動詞,只能使用名詞,而其必須是複數 4 使用標準的http方法,由http動詞組成 get sel...