面試 restful規範

2022-06-26 07:45:08 字數 973 閱讀 6751

# rest: 表徵性狀態轉移(representational state transfer)

# restful規範:web資料請求介面設計規範

'''1)通常使用https請求

2)網域名稱:有api關鍵字出現

--   (存在跨域問題)

-- 3)版本:不同版本需要標註

-- /v1 | -- /1

-- /v2 | -- /2

4)資源:請求的目標資料稱之為資源,資源一般都有名詞複數表示

-- /v1/books  (之前不規範的案例: /get_books/)

5)操作方式:不從請求鏈結體現操作方式,從請求方式上決定操作方式

-- get:/v1/books  獲取所有

-- post:/v1/books  新增一本

-- put:/v1/book/1  更新id=1的一本

-- patch:/v1/book/1  更新id=1的一本

-- delete:/v1/book/1  刪除id=1的一本

6)資源過濾:通過介面傳遞引數來過濾資源

-- /v1/books?limit=10  限制10條

7)狀態碼:返回資料要標準狀態碼,通過在資料中

-- success("0", "查詢成功")

-- nodata("1xx", "非正確,無資料,顯示基本資訊")

-- feailed("2xx", "查詢失敗")

8)錯誤資訊:請求失敗需要標註錯誤資訊 

9)操作結果:請求操作成功的返回結果

-- get:返回資源列表 | 返回單一資源

-- post:返回單一新增資源

-- put:返回更新的資源

-- patch:返回更新的資源

-- delete:返回空文件

10)子資源返回資源介面:返回的資源如果有子資源,返回子資源的鏈結位址,如查詢書,書的封面就可以url表示

'''

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...