开发与工程 · 进阶
REST(接口设计风格)
Representational State Transfer
REST 是设计软件接口的一套通用风格,用统一的地址和动作规定怎么要数据,让不同系统对接时少费口舌。
TL;DR三十秒版本
- 设计软件之间怎么互相要数据的一套通用做法,不是某个具体产品。
- 它把“要什么”和“做什么”分开讲清,大家照同一套习惯对接。
- 它只是风格不是硬标准,不同公司做出来的细节仍有出入。
Overview详细说说
REST 是一种设计接口的思路和风格,而不是某个具体产品。它规定软件之间怎么请求和回应才算清晰:每类数据有自己的地址,想查看就用取、想新增就用寄、想修改就用改、想删除就用删,把动作和对象分开表达。
需要统一风格,是因为各家接口若都自创一套规矩,对接的人每次都得重新学一遍。REST 让大家沿用同一套习惯,看到地址和动作大致就能猜到会发生什么,沟通成本因此大幅下降。比如要拿某个用户的信息,就用取的动作访问用户这个地址,地址里带上编号,含义一眼可辨。
你在技能文案里看到 REST API,意思是这个软件提供的接口是按 REST 风格设计的。它更像一套交通规则,而不是车辆本身。对使用者来说不必深究细节,能和别的接口区分开就够了。
要澄清的是,REST 是风格而非强制标准。不同公司各自设计的 REST 接口,细节上也会有差异,别指望它们完全一模一样。真正对接之前,仍然要以对方给的说明文档为准,先要一份接口文档再动手,比凭猜测试要可靠得多。
它常和另一种叫 RPC 的风格被人拿来对比,后者更强调直接调用某个动作。两者各有适用的场景,轮不到自己选的时候,照着文档用就好。
Myths常见误解
- ✕以为 REST 是某个软件或产品 ✓它是一套设计接口的风格,本身装不了也看不见
- ✕以为所有 REST 接口都长一样 ✓各家公司细节不同,真对接前要看对方给的说明文档
- ✕以为照习惯猜地址就能连上 ✓能要什么、怎么要,都以对方文档为准,猜错就白忙
In practice你会在哪用到它
- 拿到一份接口说明文档,照它的地址和规则去取数据
- 看某个工具介绍写着“提供 REST API”,知道它能被别的程序调用
- 对接前先向对方要一份接口文档,再动手试
Summary记住这几点就够了
- 设计接口的一套通用风格,不是产品
- 用统一的地址和动作规范请求方式
- REST API 说明接口按这套风格设计
- 是风格不是强制标准,细节有差异
常见问题
REST(接口设计风格)是什么意思?
设计软件之间怎么互相要数据的一套通用做法,不是某个具体产品。它把“要什么”和“做什么”分开讲清,大家照同一套习惯对接。它只是风格不是硬标准,不同公司做出来的细节仍有出入。
REST(接口设计风格)一般用在什么地方?
拿到一份接口说明文档,照它的地址和规则去取数据;看某个工具介绍写着“提供 REST API”,知道它能被别的程序调用;对接前先向对方要一份接口文档,再动手试。
关于REST(接口设计风格),最容易搞错的是什么?
以为 REST 是某个软件或产品,其实它是一套设计接口的风格,本身装不了也看不见;以为所有 REST 接口都长一样,其实各家公司细节不同,真对接前要看对方给的说明文档。
REST(接口设计风格)要记住哪几点?
设计接口的一套通用风格,不是产品;用统一的地址和动作规范请求方式;REST API 说明接口按这套风格设计;是风格不是强制标准,细节有差异。
容易踩的坑 REST 是设计风格不是标准产品,不同公司的实现细节并不一致。
Also written as你可能还会看到这些写法
这些都是同一个概念,在技能介绍里指代的是同一件事 —— 不必因为写法不同而以为是两个东西。
全站第 72 / 186 条 · 全部词条
接着读Related reading
算法(Algorithm)
算法就是做一件事的固定步骤清单。照着一步步做,同样的输入总能得到同样的结果,电脑就是靠它来完成任务的。
开源(Open Source)
开源就是作者把软件的配方和做法都公开出来,谁都能免费看、免费用,还能改了再分享给别人。
GitHub(代码托管平台)
GitHub 是全球程序员存放和分享代码的网站,既能当作品集,也是大家一起改同一份代码的协作台。
前端(Frontend)
前端是软件里你能看见、能点的那一层。按钮、图片、页面动画,都是它做出来的。
后端(Backend)
后端是软件里用户看不见的那一半。你在界面上点的每一步,背后都由它去查数据、做判断。
自动化(Automation)
自动化就是让电脑按你定好的规则重复做事,把每次都要手动做一遍的活整个交出去。