理解 RESTful API

最新推荐文章于 2024-07-05 22:57:43 发布

sigmarising

最新推荐文章于 2024-07-05 22:57:43 发布

阅读量180

点赞数

分类专栏： Web 开发文章标签： REST RESTful RESTful API

本文链接：https://blog.csdn.net/sigmarising/article/details/88777310

版权

31 篇文章 0 订阅

订阅专栏

24 篇文章 0 订阅

订阅专栏

REST（REpresentational State Transfer），即“表现层状态转移”，最早出现在 Roy Thomas Fielding （参与设计了 HTTP 协议、Apache 服务器）的博士论文中（2000年）。

论文地址：Architectural Styles and
the Design of Network-based Software Architectures

RESTful 是一种 API 的设计风格，其相比 SOAP 和 XML-RPC 更为简洁易用，现已经得到大范围应用。

REST 描述的是在网络中 client 和 server 的一种交互形式，但 REST 本身不实用，实用的是如何设计 RESTful API（REST风格的网络接口）。

URI 中只使用名词（一般是复数形式）来指定资源，原则上禁止使用动词。API 应部署到专有域名下，可以考虑加入 API 的版本。

API 应支持对于 {id} 单个资源的操作。

https://api.test.com/v1/books 		# 一组资源
https://api.test.com/v1/books/137	# 单个资源 

# 错误的例子
https://api.test.com/v1/getBooks	# API 中出现了动词

值得注意的是，RESTful 并没有“正式”的标准，所以不同 Web 应用中，HTTP 动词代表的语义可能有所差异，但大致都是相似的。

Server 和 Client 之间使用某种表现形式来传递资源，通常是 json，也可以是其他形式。

通过 HTTP 的状态码，可以直观反映结果。

Web 端不必使用 PHP、JSP、ASP 架构，改为前端渲染、前端路由（Angular、React、Vue）。Web 端和 Server 只使用 RESTful API 来传递数据和改变数据状态。

关注

专栏目录