認識Restful API

qylost 發布于2019-08-16 15:38 / 2600人閱讀

摘要：直接翻譯的意思是表現層狀態轉化。它是一種互聯網應用程序的設計理念定位資源，用動詞描述操作。

Restful API

REST，即Representational State Transfer的縮寫。直接翻譯的意思是"表現層狀態轉化"。它是一種互聯網應用程序的API設計理念：URL定位資源，用HTTP動詞（GET,POST,DELETE,DETC）描述操作。

實現基礎

近年來移動互聯網的發展，前端設備層出不窮（手機、平板、桌面電腦、其他專用設備......），因此，必須有一種統一的機制，方便不同的前端設備與后端進行通信,于是RESTful誕生了，它可以通過一套統一的接口為 Web，iOS和Android提供服務。

常用的URL請求方式

HEAD（SELECT）只獲取某個資源的頭部信息

GET（SELECT）獲取資源

POST（CREATE）創建資源

PATCH（UPDATE）更新資源的部分屬性（很少用，一般用POST代替）

PUT（UPDATE）更新資源，客戶端需要提供新建資源的所有屬性

DELETE（DELETE）刪除資源

狀態碼

狀態碼
字段名稱為：code
200 OK [GET] 服務器成功返回用戶請求的數據，該操作是冪等的（Idempotent）
201 CREATED [POST/PUT/PATCH] 用戶新建或修改數據成功
202 ACCEPTED [*] 表示一個請求已經進入后臺排隊（異步任務）
204 NO CONTENT [DELETE] 用戶刪除數據成功
400 INVALID REQUEST [POST/PUT/PATCH] 用戶發出的請求有錯誤，服務器沒有進行新建或修改數據的操作，該操作是冪等的
401 UNAUTHORIZED [*] 表示用戶沒有權限（令牌、用戶名、密碼錯誤）
403 FORBIDDEN [*] 表示用戶得到授權（與401錯誤相對），但是訪問是被禁止的
404 NOT FOUND [*] 用戶發出的請求針對的是不存在的記錄，服務器沒有進行操作，該操作是冪等的
406 NOT ACCEPTABLE [GET] 用戶請求的格式不可得（比如用戶請求JSON格式，但是只有XML格式）
410 GONE [GET] 用戶請求的資源被永久刪除，且不會再得到的
422 UNPROCESABLE ENTITY [POST/PUT/PATCH] 當創建一個對象時，發生一個驗證錯誤
500 INTERNAL SERVER ERROR [*] 服務器發生錯誤，用戶將無法判斷發出的請求是否成功

注意

為了簡便,在web設計中,有時候會統一"code:0"代表請求成功,"code:1"代表請求失敗,狀態碼為0,對應返回data字段,狀態碼為1對應返回message字段.

文章版權歸作者所有，未經允許請勿轉載,若此文章存在違規行為，您可以聯系管理員刪除。

轉載請注明本文地址：http://specialneedsforspecialkids.com/yun/73604.html

Swagger 生成 PHP restful API 接口文檔

摘要：需求和背景需求為客戶端同事寫接口文檔的各位后端同學已經在各種場合回憶了使用自動化文檔工具前手寫文檔的血淚史我的故事卻又不同因為首先來說我在公司是組負責人屬于上述血淚史中催死人不償命的客戶端陣營但血淚史卻是相通的沒有自動化文檔的日子對接口就是需求和背景需求: 為客戶端同事寫接口文檔的各位后端同學,已經在各種場合回憶了使用自動化文檔工具前手寫文檔的血淚史.我的故事卻又不同,因為首先來說...

xiaotianyi 2019-06-28 18:43 評論0 收藏0
#yyds干貨盤點#帶你統一認識一下系統架構及分析和總結

摘要：缺點系統依賴復雜，給開發測試部署帶來不便，分布式數據一致性和分布式事務支持困難，一般通過最終一致性簡化解決。微服務架構分成三種實現模式。事件驅動架構事件是狀態發生變化時，軟件發出的通知。事件驅動架構的四個部分事件隊列接收事件的入口。架構的規劃誰架構就是對系統中的實體以及實體之間的關系所進行的抽象描述，是決策。...

warkiz 2021-11-25 09:43 評論0 收藏0
GraphQL：一種更高效、強大和靈活的數據提供方式

摘要：我們知道是一種從服務器公開數據的流行方式。描述所有的可能類型系統基于類型和字段的方式進行組織，而非入口端點。因此，需要對后端進行調整，以滿足新的數據需求，這會降低生產力并顯著降低將用戶反饋集成到產品中的能力。 showImg(https://segmentfault.com/img/remote/1460000017875905?w=2234&h=974); 在前幾天的《StateOf...

waruqi 2019-07-01 11:12 評論0 收藏0
GraphQL：一種更高效、強大和靈活的數據提供方式

摘要：我們知道是一種從服務器公開數據的流行方式。描述所有的可能類型系統基于類型和字段的方式進行組織，而非入口端點。因此，需要對后端進行調整，以滿足新的數據需求，這會降低生產力并顯著降低將用戶反饋集成到產品中的能力。 showImg(https://segmentfault.com/img/remote/1460000017875905?w=2234&h=974); 在前幾天的《StateOf...

zzbo 2019-08-23 14:41 評論0 收藏0