RESTful 是什么

一、核心定义

REST ：全称 Representational State Transfer ，表述性状态转移，是一种软件架构设计风格 / 规范 ，不是协议、不是标准。RESTful ：指遵循 REST 设计规范开发的接口 / 服务，日常说的「RESTful 接口」就是符合这套规则的前后端 API。

主要用于：前后端分离、微服务、第三方接口调用（手机 App、小程序、前端网页调后端接口）。

---

二、核心设计思想

1. 资源为核心 所有东西都抽象为资源（用户、订单、商品、文章），每个资源有唯一 URL。
2. 无状态服务器不存储客户端会话信息，每次请求带完整参数 / 令牌（Token），服务易扩容、集群部署。
3. 用 HTTP 原生方法表达操作意图 不只用 POST 混用所有操作，严格区分：

• GET：查询、获取数据（安全、幂等）
• POST：新增资源
• PUT：全量更新 / 修改资源
• PATCH：局部更新
• DELETE：删除资源

---

三、RESTful 接口规范示例（对比传统接口）

❶ 传统接口（不规范）

plaintext

获取用户：/getUser?userId=1
新增用户：/addUser
修改用户：/updateUser
删除用户：/delUser?userId=1

❷ RESTful 规范写法

plaintext

# 用户资源
GET    /users/1      # 查询id=1的用户
POST   /users        # 新增用户
PUT    /users/1      # 修改id=1的用户
DELETE /users/1      # 删除id=1的用户

• URL 用名词复数（users、orders、goods）
• 动作交给 HTTP 方法，URL 只写资源

---

四、配套规范

1. 返回格式统一：统一用 JSON
2. 状态码语义化
   • 200 成功、201 创建成功
   • 400 参数错误、401 未登录、403 无权限、404 资源不存在
   • 500 服务异常
3. 版本控制 ：/api/v1/users 方便迭代兼容
4. 过滤 / 分页 / 排序 通过 URL 参数：/users?page=1&size=10&sort=createTime

---

五、优缺点

优点

• 结构清晰、语义直观，前后端协作简单
• 适配前后端分离、微服务、跨端调用
• 无状态，天然适合分布式、负载均衡

缺点

• 部分场景语义别扭（复杂业务操作）
• 严格 REST 开发略繁琐，很多公司会弱化 REST（只保留风格，不完全严格）

---

六、通俗一句话总结

RESTful 就是利用 HTTP 原生请求方式，以「资源」为中心，统一、规范、简洁地设计后端 API 接口的一套开发风格，是目前互联网项目、金融系统、微服务最主流的接口设计方式。