web介面與restful規範

2022-01-10 22:08:46 字數 1284 閱讀 5981

通過網路,規定了前後臺資訊互動規則的url鏈結,在web程式中也就是聯絡前台頁面與後台資料庫的媒介.

請求方式:get、post、put、patch、delete

請求引數:json或xml格式的key-value型別資料

響應結果:json或xml格式的資料

全稱是 resource representational state transfer:通俗來講就是:資源在網路中以某種表現形式進行狀態轉移, 分解開來說明:

restful由於其面向資源介面設計以及操作抽象簡化了開發者的不良設計,同時也最大限度的利用了http最初的應用協議設計理念. restful的設計一般分為2部分來看, url請求部分和response響應部分.

url用api關鍵字標識介面url

介面資料安全性決定優先選擇https協議

如果乙個介面有多版本存在,需要在url中標識體現

介面操作的資料來源稱之為 資源,在url中一般採用資源複數形式,乙個介面可以概括對該資源的多種操作方式

請求方式有多種,用乙個url處理如何保證不混亂 - 通過請求方式標識操作資源的方式

"""

/books get 獲取所有

/books post 增加乙個(多個)

/books/(pk) delete 刪除乙個

/books/(pk) put 整體更新乙個

/books/(pk) patch 區域性更新乙個

"""

資源往往涉及資料的各種操作方式 - 篩選、排序、限制

api.baidu.com/books/?search=西&ordering=-price&limit=3

response

http請求的響應會有響應狀態碼,介面用來返回操作的資源資料,可以擁有 運算元據結果的 狀態碼

status 0(操作資源成功) 1(操作資源失敗) 2(操作資源成功,但沒匹配結果)

注:資源狀態碼不像http狀態碼,一般都是後台與前台或是客戶約定的

資源的狀態碼文字提示

status ok '賬號有誤' '密碼有誤' '使用者鎖定'

資源本身

results

注:刪除資源成功不做任何資料返回(返回空字串)

restful介面規範

資源 resource 任何東西都是一種資源,例如,一篇部落格文章 表示 representation 資源的一種表現形式,例如,json xml url 每個資源都應該有乙個對應的url uri url是uri的一種,url都有對應的資源,而uri不一定,它強調的是一種資源標識 get 獲得乙個資...

restful介面規範

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

Restful介面規範

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