术语图鉴/后端基础/RESTful
←→切换Esc返回

RESTful REST API

你可能会说

这个RESTful的逻辑我不太懂,帮我解释一下然后实现它。

一种设计 API 的风格规范:用不同的「动作」表示不同操作——GET(获取)、POST(创建)、PUT(修改)、DELETE(删除)。

一种设计 API 的风格规范:用不同的「动作」表示不同操作——GET(获取)、POST(创建)、PUT(修改)、DELETE(删除)。

也常被叫作REST API

生活类比

像图书馆规则:「借」是 GET,「还」是 POST,「改预约」是 PUT,「注销」是 DELETE。

🎮 动手试试

RESTful API 端点设计

GET/users— 列表
GET/users/:id— 详情
POST/users— 创建
PUT/users/:id— 更新
DELETE/users/:id— 删除
选择题选择一个你认为最合适的答案

关于「RESTful」,以下哪个描述最准确?

你可以这样告诉 AI

帮我把现有的增删改查接口改成 RESTful 风格:GET 查、POST 增、PUT 改、DELETE 删,URL 用名词复数。

容易混淆?这样区分

RESTful REST API≠
API API

REST 是设计 API 的一种风格规范(用动词区分操作),API 是程序间通信的通用概念,REST 只是 API 的实现方式之一。

什么时候用

设计增删改查接口

用 GET 获取、POST 创建、PUT 更新、DELETE 删除,遵循 REST 规范让接口语义清晰、前后端协作更顺畅。

和 AI 协作时

想让 AI 帮你设计 REST 接口时,直接说「帮我按 REST 风格设计用户模块的 CRUD 接口,用 Express 路由实现」。

什么时候不用

简单内部工具

如果只有一个两个接口的内部小工具,不必严格遵循 REST 规范,简化的 RPC 风格反而更省事。

与 API 设计无关的项目

如果你只做纯前端展示页或静态内容,不需要设计接口,REST 规范对你没有意义。

组成结构 · Anatomy

1
核心概念Core

一种设计 API 的风格规范:用不同的「动作」表示不同操作——GET(获取)、POST(创建)、PU

2
实际表现In Practice

像图书馆规则:「借」是 GET,「还」是 POST,「改预约」是 PUT,「注销」是 DELETE。

3
与 AI 的关联AI Context

和 AI 沟通时提到「写个 REST 接口」,就是按这套规范设计增删改查的 URL。

典型使用场景

重构 API 风格
告诉 AI「帮我把接口改成 RESTful 风格,URL 用名词复数,方法用 GET/POST/PUT/DELETE」
想弄懂概念时
告诉 AI「用大白话给我解释什么是RESTful,举个生活中的例子」

延伸阅读