restful介面規範

2021-08-07 17:38:24 字數 1025 閱讀 2318

資源(resource):任何東西都是一種資源,例如,一篇部落格文章

表示(representation):資源的一種表現形式,例如,json、xml

url:每個資源都應該有乙個對應的url

uri:url是uri的一種,url都有對應的資源,而uri不一定,它強調的是一種資源標識

get:獲得乙個資源的一種表示

原則上所有的get操作都是安全操作,意思是get不會更改資料。但也有例外,對於一些無關緊要的操作,也可以用get,例如,更新乙個counter

返回碼:

200 ok

post:提供乙個表示,建立乙個資源

返回碼:

201 created:建立成功

202 accepted:伺服器已經接受了請求,但還沒有建立

overloaded post

例如,在乙個html表單裡面,更改博文的操作是post,因為html不允許表單使用put。類似的場景中,post包含了多種含義,被稱為overloaded post。已經無法在協議語義裡面區分了,需要在程式語義裡面區分。 推薦不要使用overloaded post

put:用乙個完整的表示,替換乙個資源

返回碼:

200 ok:更新成功

delete:刪除乙個資源

返回碼:

200 ok

head:獲取表示的頭資訊

options:探測url支援的操作

安全性:操作不修改資源,get、head和options是安全的。*是否get就不能修改資料?不一定,對於一些細小的操作,get也可以修改資料,例如,訪問乙個url增加counter的值

冪等性:除了安全的操作以外,delete、put、patch也應該是冪等的

restful介面規範

聯絡兩個物質的媒介,完成資訊互動 web程式中 聯絡前台頁面與後台資料庫的媒介 web介面組成 請求引數 前台按照指定的key提供資料給後台 響應資料 後台與資料庫互動後將資料反饋給前台 狀態碼,狀態資訊,響應資料 web資料請求介面設計規範共10條,可以分為url與響應兩部分 url 響應部分 f...

Restful介面規範

2000年roy fielding博士在其博士 中提出rest representational state transfer 風格的軟體架構模式後,rest就基本上迅速取代了複雜而笨重的soap,成為web api的標準了。restful作為目前最流行的 api 設計規範,一定有著它獨有的魅力 強...

Restful介面規範

rest,即resources representational state transfer 資源表現層狀態轉化 資源 resources 網路上的乙個實體,每種資源對應乙個特定的uri 統一資源識別符號 表現層 representational 資源呈現的形式,比如 json 狀態轉化 stat...