搞懂 RESTful API

https://apifox.com/blog/a-cup-of-tea-time-to-understand-restful-api/

什么是 RESTful API

• 在互联网并没有完全流行的初期，移动端也没有那么盛行，页面请求和并发量也不高，那时候人们对接口（API）的要求没那么高。
• 当初的 web 应用程序主要是在服务器端实现的，因此需要使用复杂的协议来操作和传输数据。然而，随着移动端设备的普及，需要在移动端也能够访问 web 应用程序，而客户端和服务端就需要接口进行通信，但接口的规范性就又成了一个问题。

• 所以一套简化开发、结构清晰、符合标准、易于理解、易于扩展让大部分人都能够理解接受的接口风格就显得越来越重要，而 RESTful 风格的接口 (RESTful API) 刚好有以上特点，就逐渐应运而生。

REST

• REST，全名 Representational State Transfer (表现层状态转移)，他是一种设计风格，一种软件架构风格，而不是标准，只是提供了一组设计原则和约束条件。

RESTful

• RESTful 只是转为形容詞，就像那么 RESTful API 就是满足 REST 风格的，以此规范设计的 API。

RESTful API

• 我们常见的 API 一般都长这样子：

• 而 RESTful 风格的 API 却长这样子：

六大原则

Uniform Interface（统一接口）

• 就像我们上面两幅图看到的 API，这是最直观的特征，是 REST 架构的核心，统一的接口对于 RESTful 服务非常重要。客户端只需要关注实现接口就可以，接口的可读性加强，使用人员方便调用。
• RESTful API 通过 URL 定位资源，并通过 HTTP 方法操作该资源，对资源的操作包括获取、创建、修改和删除，这些操作正好对应 HTTP 协议提供的 GET、POST、PUT 和 DELETE 方法。

GET：获取资源信息。

POST：创建一个新资源。

PUT：更新已有的资源。

DELETE：删除已有的资源。

• 在一个完全遵循 RESTful 的团队里，后端只需要告诉前端 /users 这个 API，前端就应该知道:

获取所有用户：GET /users

获取特定用户：GET /users/{id}

创建用户：POST /users

更新用户：PUT /users/{id}

删除用户：DELETE /users/{id}

• 当 API 数量非常多，系统非常复杂时，RESTful 的好处会越来越明显。理解系统时，可以直接围绕一系列资源来理解和记忆。

Client-Server（客户端和服务端分离）

• 它意味着客户端和服务器是独立的、可以分离的。
• 客户端是负责请求和处理数据的组件，服务器是负责存储数据和处理请求的组件。
• 这两个组件之间通过一组约定来协作，以便客户端能够获取所需的数据。

Statelessness（无状态）

• 它指的是每个请求都是独立的，没有前后关系。服务器不保存客户端的状态信息，并且每个请求都必须包含所有所需的信息。
• 这样做的好处是可以使每个请求变得简单，容易理解和处理，并且可以更容易地扩展和维护。
• 例如，假设你在登录一个网站，你需要在登录界面输入用户名和密码通过接口获取到了 token 。接下来的所有请求都需要携带上这个 token   而不是系统在第一次登录成功之后记录了你的状态。