搞懂 RESTful API

发布时间 2023-08-28 10:49:47作者: gogoy

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   而不是系统在第一次登录成功之后记录了你的状态