RESTful 規範和Postman除錯

2021-10-06 01:15:57 字數 1961 閱讀 1491

什麼是restful:

restful本質是一種軟體架構風格,其核心是面向資源,能降低開發的複雜性和提高系統的可伸縮性。

設計概念和準則:

網路上的所有事物都可以被抽象為資源

每乙個資源都有唯一的資源標識,對資源的操作不會改變這些標識。

所有的操作都是無狀態的

soap和rest的區別

效率和易用性:

安全性:

安全性:soap會好於rest

效率和易用性:rest更勝一籌

成熟度:總的來說soap在成熟度上優於rest

如何設計restful風格api(動物園為例)

資源路徑(uri)–>http動詞 -->過濾資訊–>狀態碼–>錯誤處理–>返回結果

資源路徑:在restful架構中每個**代表一種資源 ,所以**中不能有動詞,只能有名詞。一般來說api中的名詞應該使用複數。

舉例來說,有乙個api提供動物園(zoo)的資訊,還包括各種動物和雇員的資訊,則它的路徑應該設計成下面這樣。

http動詞:對於資源的操作(curd),由http動詞(謂詞)表示。

舉例
過濾資訊:如果記錄數量很多,伺服器不可能都將它們返回給使用者。api應該提供引數,過濾返回結果。

舉例

狀態碼:伺服器向使用者返回的狀態碼和提示資訊,使用標準http狀態碼。

錯誤處理:如果狀態碼是4xx或者5xx,就應該向使用者返回出錯資訊。一般來說,返回的資訊中將error作為鍵名,出錯資訊作為鍵值即可

返回結果:針對不同操作,伺服器向使用者返回的結果應該符合以下規範:

get /collections :返回資源物件的列表(陣列)

get /collections/identity :返回單個資源物件

post /collections :返回新生成的資源物件

put /collections/identity :返回完整的資源物件

patch / collections/identity :返回被修改的屬性

delete / collections/identity : 返回乙個空文件

rest風格的介面測試流程

了解介面格式—>編寫測試用例—>測試用例評審—>開始測試—>完成測試報告—>結束

使用postman驗證測試用例

restful規範和restframework框架

介面可以理解為url就是介面.那麼在其他語言裡面介面也可以是約束類 restful是目前最流行的一種網際網路軟體架構。它結構清晰 符合標準 易於理解 擴充套件方便,所以正得到越來越多 的採用。url 1.url體現版本 2.url體現是api 3.用https 4.條件 5.面向資源程式設計 6.根...

restful介面規範

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

restful規範介紹

團隊之間協作有很多的介面規範,團隊做大了,平台之間的資料傳輸的規範需要定義好。需要有乙個閥,restful 就是這樣的乙個規範,我們都應該遵守這樣的乙個規範。越來越多的人意識到,即軟體,而且是一種新型的軟體 開發,完全可以採用軟體開發的模式。但是傳統上,軟體和網路是兩個不同的領域,網際網路的興起讓這...