RESTful API 設計指南

2021-08-21 08:54:32 字數 1035 閱讀 7097

技術交流的時候遇到了這樣的乙個問題,被問及開發中用到的是不是restful api,我說的是,我們現在用到的不屬於完全是restful api。因為我了解到的restful api,是 通過具體的uri定位符,找到對應的資源,然後以固定的格式返回資料,這樣的才是restful api。然而在我模糊的表達中,對方聽出來的是,我現在開發的api依然屬於restful api。那麼什麼才是真正的restful api呢,今天我想好好總結一下。(之前學習東西總是,用到了就去搜尋,然後很少總結,類似這種不影響我開發的概念性東西,只是大致搜尋後,有了了解,不求甚解的。現在看來還是有必要弄的更清楚的,因為在討論的時候,容易出現偏差,描述不清楚,對於學習其他知識的時候也是不利的。) 

此處說明一下,我看到的是

如何使用retrofit請求非restful api

,這個讓我理解了什麼不是restful api,結果是不對的。不過不要緊,這篇部落格的重點不是這個。

什麼是rest?

可以總結為一句話:rest是所有web應用都應該遵守的架構設計指導原則。 

representational state transfer,翻譯是」表現層狀態轉化」。 

面向資源是rest最明顯的特徵,對於同乙個資源的一組不同的操作。資源是伺服器上乙個可命名的抽象概念,資源是以名詞為核心來組織的,首先關注的是名詞。rest要求,必須通過統一的介面來對資源執行各種操作。對於每個資源只能執行一組有限的操作。(7個http方法:get/post/put/delete/patch/head/options)

什麼是restful api?

符合rest架構設計的api。

總結符合rest設計標準的api,即restful api。rest架構設計,遵循的各項標準和準則,就是http協議的表現,換句話說,http協議就是屬於rest架構的設計模式。比如,無狀態,請求-響應。。。

參考: 

理解本身的rest架構風格 

理解restful架構 

restful api設計指南

python flask api 介面開發

RESTful API 設計指南

網路應用程式,分為前端和後端兩個部分。當前的發展趨勢,就是前端裝置層出不窮 手機 平板 桌面電腦 其他專用裝置 因此,必須有一種統一的機制,方便不同的前端裝置與後端進行通訊。這導致api構架的流行,甚至出現 api first 的設計思想。restful api是目前比較成熟的一套網際網路應用程式的...

RESTful API 設計指南

網路應用程式,分為前端和後端兩個部分。當前的發展趨勢,就是前端裝置層出不窮 手機 平板 桌面電腦 其他專用裝置.因此,必須有一種統一的機制,方便不同的前端裝置與後端進行通訊。這導致api構架的流行,甚至出現 api first 的設計思想。restful api是目前比較成熟的一套網際網路應用程式的...

RESTful API 設計指南

原文 網路應用程式,分為前端和後端兩個部分。當前的發展趨勢,就是前端裝置層出不窮 手機 平板 桌面電腦 其他專用裝置.因此,必須有一種統一的機制,方便不同的前端裝置與後端進行通訊。這導致 api 構架的流行,甚至出現 api first 的設計思想。restful api 是目前比較成熟的一套網際網...