Development & Engineering · Intermediate
REST(接口设计风格)
Representational State Transfer
REST 是设计软件接口的一套通用风格,用统一的地址和动作规定怎么要数据,让不同系统对接时少费口舌。
Some fields on this page have no English version yet — they are shown in the original Chinese.
TL;DRIn 30 seconds
- 设计软件之间怎么互相要数据的一套通用做法,不是某个具体产品。
- 它把“要什么”和“做什么”分开讲清,大家照同一套习惯对接。
- 它只是风格不是硬标准,不同公司做出来的细节仍有出入。
OverviewIn detail
REST 是一种设计接口的思路和风格,而不是某个具体产品。它规定软件之间怎么请求和回应才算清晰:每类数据有自己的地址,想查看就用取、想新增就用寄、想修改就用改、想删除就用删,把动作和对象分开表达。
需要统一风格,是因为各家接口若都自创一套规矩,对接的人每次都得重新学一遍。REST 让大家沿用同一套习惯,看到地址和动作大致就能猜到会发生什么,沟通成本因此大幅下降。比如要拿某个用户的信息,就用取的动作访问用户这个地址,地址里带上编号,含义一眼可辨。
你在技能文案里看到 REST API,意思是这个软件提供的接口是按 REST 风格设计的。它更像一套交通规则,而不是车辆本身。对使用者来说不必深究细节,能和别的接口区分开就够了。
要澄清的是,REST 是风格而非强制标准。不同公司各自设计的 REST 接口,细节上也会有差异,别指望它们完全一模一样。真正对接之前,仍然要以对方给的说明文档为准,先要一份接口文档再动手,比凭猜测试要可靠得多。
它常和另一种叫 RPC 的风格被人拿来对比,后者更强调直接调用某个动作。两者各有适用的场景,轮不到自己选的时候,照着文档用就好。
MythsCommon misunderstandings
- ✕以为 REST 是某个软件或产品 ✓它是一套设计接口的风格,本身装不了也看不见
- ✕以为所有 REST 接口都长一样 ✓各家公司细节不同,真对接前要看对方给的说明文档
- ✕以为照习惯猜地址就能连上 ✓能要什么、怎么要,都以对方文档为准,猜错就白忙
In practiceWhere you will meet it
- 拿到一份接口说明文档,照它的地址和规则去取数据
- 看某个工具介绍写着“提供 REST API”,知道它能被别的程序调用
- 对接前先向对方要一份接口文档,再动手试
SummaryThe key points
- 设计接口的一套通用风格,不是产品
- 用统一的地址和动作规范请求方式
- REST API 说明接口按这套风格设计
- 是风格不是强制标准,细节有差异
FAQ
What does REST(接口设计风格) mean?
设计软件之间怎么互相要数据的一套通用做法,不是某个具体产品。它把“要什么”和“做什么”分开讲清,大家照同一套习惯对接。它只是风格不是硬标准,不同公司做出来的细节仍有出入。
Where will I run into REST(接口设计风格)?
拿到一份接口说明文档,照它的地址和规则去取数据;看某个工具介绍写着“提供 REST API”,知道它能被别的程序调用;对接前先向对方要一份接口文档,再动手试。
What do people most often get wrong about REST(接口设计风格)?
以为 REST 是某个软件或产品 — but 它是一套设计接口的风格,本身装不了也看不见;以为所有 REST 接口都长一样 — but 各家公司细节不同,真对接前要看对方给的说明文档。
What are the key points about REST(接口设计风格)?
设计接口的一套通用风格,不是产品;用统一的地址和动作规范请求方式;REST API 说明接口按这套风格设计;是风格不是强制标准,细节有差异。
Common pitfalls REST 是设计风格不是标准产品,不同公司的实现细节并不一致。
Also written asYou may also see it written as
These are all the same concept — the same thing, however it is written in a skill description. Do not mistake different spellings for different ideas.
Entry 72 of 186 · All entries
Keep readingRelated reading
算法(Algorithm)
算法就是做一件事的固定步骤清单。照着一步步做,同样的输入总能得到同样的结果,电脑就是靠它来完成任务的。
Open Source
Open source means the author publishes the recipe as well as the software. Anyone can read it, use it for free, and even change it and pass it on.
GitHub(代码托管平台)
GitHub 是全球程序员存放和分享代码的网站,既能当作品集,也是大家一起改同一份代码的协作台。
前端(Frontend)
前端是软件里你能看见、能点的那一层。按钮、图片、页面动画,都是它做出来的。
Backend
The backend is the half of the software you never see. Every step you take in the interface is handled behind the scenes by it, looking up data and making the decisions.
Automation
Automation means letting a computer repeat a job by rules you set, so work you would otherwise redo by hand every time is handed over entirely.
Where to go nextExplore more
Back to the skills themselves
Most of the concepts covered here come from skills that install into your AI client with a single command.