RESTful 是什么 - 技术栈

一、核心定义

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

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

二、核心设计思想

资源为核心 所有东西都抽象为资源（用户、订单、商品、文章），每个资源有唯一 URL。
无状态服务器不存储客户端会话信息，每次请求带完整参数 / 令牌（Token），服务易扩容、集群部署。
用 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 只写资源

四、配套规范

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

五、优缺点

优点

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

缺点

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

六、通俗一句话总结

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