前言

本文整理了RESTful架构风格的简单概述，如果对本文有不一样见解的同学欢迎评论区补充讨论，当然有问题，也欢迎在评论区指出。

主要借鉴：阮一峰老师的理解RESTful架构这篇文章

1. RESTful理解

REST（Representational State Transfer）是"表现层状态转化"。如果一个架构符合REST原则，就称它为RESTful架构。

（一）资源（Resources）

REST的名称"表现层状态转化"中，省略了主语。"表现层"其实指的是"资源"的"表现层"

所谓"资源"，就是网络上的一个实体，或者说是网络上的一个具体信息。 它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的实在。你可以用一个URI（统一资源定位符）指向它，每种资源对应一个特定的URI。要获取这个资源，访问它的URI就可以，因此URI就成了每一个资源的地址或独一无二的识别符

（二）表现层（Representation）

"资源"是一种信息实体，它可以有多种外在表现形式。我们把"资源"具体呈现出来的形式，叫做它的"表现层"。

比如，文本可以用txt格式表现，也可以用HTML格式、XML格式、JSON格式表现，甚至可以采用二进制格式；图片可以用JPG格式表现，也可以用PNG格式表现。

（三）状态转化（State Transfer）

访问一个网站，就代表了客户端和服务器的一个互动过程。在这个过程中，势必涉及到数据和状态的变化。

互联网通信协议HTTP协议，是一个无状态协议。这意味着，所有的状态都保存在服务器端。因此，如果客户端想要操作服务器，必须通过某种手段，让服务器端发生"状态转化"。而这种转化是建立在表现层之上的，所以就是"表现层状态转化"。

客户端用到的手段，只能是HTTP协议。具体来说，就是HTTP协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。它们分别对应四种基本操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源。

（四）总的来说

RESTful架构：

每一个URI代表一种资源；
客户端和服务器之间，传递这种资源的某种表现层；
客户端通过四个HTTP动词，对服务器端资源进行操作，实现"表现层状态转化"。

2、URI规范

RESTful API 就是通过规范接口请求URL，使得接口语义化，主要是以下两个规则：

请求 API 的 URL 表示用来定位资源；
请求的 METHOD 表示对这个资源进行的操作；

URL规范

不用大写；
用中杠-不用下杠_；
URL 中不应该出现任何表示操作的动词，链接只用于对应资源；
```
/api/v1/users/get
```
URI中的名词表示资源集合，使用复数形式；比如GET /api/users表示获取用户的列表；如果获取单个资源，传入 ID，比如/api/users/123表示获取单个用户的信息；

按照资源的逻辑层级，对 URL 进行嵌套，但也不要过多层级嵌套

/api/teams （对应团队列表）
/api/teams/123 （对应 ID 为 123 的团队）
/api/teams/123/members （对应 ID 为 123 的团队下的成员列表）
/api/teams/123/members/456 （对应 ID 为 123 的团队下 ID 为 456 的成员）----/api/teams/123?members=456

总结

觉得写得好的，对你有帮助的，可以分享给身边人，知识越分享越多，千万不要吝啬呀

后续更新其它前端小知识，请关注我，整理好，分享给你们，我们一起学前端

RESTful 架构风格概述

前言