對RESTful API的理解

2021-09-25 00:10:52 字數 681 閱讀 2746

restful是目前最流行的api設計規範,用於web資料介面的設計。

一句話描述restful就是:客戶端傳送請求時,用uri定位資源,用http方法描述動作。

也就是「動詞+賓語」的結構。

get:   獲取資料

post:傳送資料

put:  更新資料

delete:刪除資料

uri應該是名詞,不能是動詞。比如,/articles這個uri就是正確的,而/getarticles就是錯誤的

uri單數還是複數?這裡沒有統一的規定,但是常見的操作是讀取乙個集合,為了統一起見,建議都用複數uri

避免多級url:常見的情況是,資源需要分多級,因此容易寫出多級的url。這種url不利於擴充套件,語義也不確定。更好的做法是,除了第一級,其他級別都用查詢字串表達。

例如:下面這兩個url,下面的url更好。

get /authors/12/categories/2

get /authors/12?categories=2

1.返回json,不要返回純文字

2.發生錯誤的時候不要返回200:有一種不恰當的做法是,即使發生錯誤,也返回200狀態碼,把錯誤資訊放在資料體裡。

對restful API的理解

restful是一種軟體設計風格,一種思想,它不是一種標準規定,不使用restful風格api,我們也能正常開發工作,它只是一種大家比較提倡的設計規範。我們平時設計介面時,常根據自己所做的功能為介面起名稱,比如要寫乙個查詢使用者列表的介面,我們可能會起 queryuser的介面名,有的人會起sele...

個人對 RESTful API 的理解

首先,先了解下rest,rest的全稱 representational state transfer,即 表現層狀態轉化 它代表著分布式服務的架構風格。只需要寫乙個後台系統提供rest風格的uri,不同的客戶端,如瀏覽器 android ios等都請求該同乙個後台系統。那麼這些前端接收到的使用者請...

說說自己對RESTful API的理解

知乎上有句話總結的很好了,url定位資源用http動詞 get post delete 描述操作。其實只要理解以下幾個原則就可以了 1.提供資源定位 一般在計算機系統中,client和server通訊交換資訊,發出action來完成任務。假設在乙個to do list的web應用中,客戶需要新增或者...