什么是 REST？现代 Web API 设计的基石

最新推荐文章于 2025-05-04 21:44:28 发布

largecode

最新推荐文章于 2025-05-04 21:44:28 发布

阅读量614

点赞数 16

分类专栏：开发基础知识文章标签：网络协议

本文链接：https://blog.csdn.net/2501_91858856/article/details/147621892

版权

开发基础知识专栏收录该内容

11 篇文章

订阅专栏

在构建 Web 应用和服务时，开发者最常接触的一种接口设计风格就是 REST（Representational State Transfer，表述性状态转移）。它已经成为构建 Web API 的事实标准，为互联网中各类系统之间的通信提供了简洁、高效的解决方案。

这篇文章将带你系统了解 REST 的定义、核心原则、设计方式、优势与不足，并帮助你更好地理解 RESTful API 的实现。

一、REST 是什么？

REST 是由计算机科学家 Roy Fielding 于 2000 年在他博士论文中提出的一种软件架构风格，它并不是一种协议，而是一种设计理念和约束规范。REST 的目标是构建一种可扩展、可缓存、统一接口的分布式系统架构。

在 Web 世界中，REST 通常指的是遵循 REST 原则所设计的 HTTP 接口（也叫 RESTful API）。

二、REST 的六大约束

REST 的架构风格基于以下六个基本约束：

约束名称	说明
客户端-服务器（Client-Server）	客户端与服务器职责分离，前后端独立开发部署
无状态（Stateless）	每个请求必须携带完成所需的全部信息，服务端不记录客户端状态
可缓存（Cacheable）	响应明确指示是否可缓存，以提升性能和减少不必要请求
统一接口（Uniform Interface）	所有资源通过统一的接口格式进行访问和操作，提高系统的通用性与可理解性
分层系统（Layered System）	系统可以由多个中间层组成，客户端无法感知是否直接连接到最终服务器
按需代码（Code on Demand，可选）	服务端可以将可执行代码（如 JavaScript）传给客户端（不常用）

三、RESTful API 的关键元素

REST 中，一切皆资源（Resource）。资源通过 URL 进行标识，通过 HTTP 方法进行操作。

1. 资源 URL 命名

RESTful API 中的 URL 应简洁、直观，使用名词表示资源：

GET     /users          # 获取用户列表
GET     /users/123      # 获取用户 ID 为 123 的信息
POST    /users          # 创建新用户
PUT     /users/123      # 更新用户信息
DELETE  /users/123      # 删除用户

2. HTTP 方法的语义

方法	用途
GET	获取资源
POST	创建资源
PUT	更新资源
DELETE	删除资源
PATCH	部分更新资源

3. 响应状态码

REST API 通常使用标准的 HTTP 状态码表示响应结果：

状态码	含义
200	请求成功
201	创建成功
204	无内容（成功但无返回）
400	错误的请求
401	未授权
403	禁止访问
404	资源未找到
500	服务器错误

四、REST 的优势

✅ 简单易懂：基于 HTTP 协议，无需额外学习新协议
✅ 松耦合：前后端职责清晰，适合敏捷开发与团队协作
✅ 通用性强：各种语言和平台都支持 HTTP 与 JSON
✅ 支持缓存：通过 HTTP 缓存机制有效减少重复请求
✅ 易于扩展与维护：资源化设计使接口具有良好的可演进性

五、REST 的局限与适用场景

局限性

❌ 不适合高频双向通信（如实时聊天、游戏）
❌ 每次请求都要携带完整上下文，性能有损耗
❌ 接口版本管理复杂，需要额外设计规范（如 /v1/users）

更适合的场景

✅ Web 前后端通信
✅ 移动 App 接口调用
✅ IoT 设备调用后台服务
✅ 公共开放接口（Open API）

对于需要长连接或高并发流式数据的场景，可考虑使用 WebSocket、gRPC、GraphQL 等替代方案。

六、REST 与其他 API 技术的对比

技术	特点	适用场景
REST	简单、稳定、广泛支持	标准 Web API，通用性强
gRPC	高性能、二进制协议、强类型定义	内部微服务通信、跨语言高性能调用
GraphQL	灵活查询，客户端定制返回字段	移动端、前端需要控制数据结构时
WebSocket	实时通信、保持连接	实时消息、聊天、游戏等