news 2026/6/10 18:36:10

还不懂 RESTful 接口是什么?快进来看看

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
还不懂 RESTful 接口是什么?快进来看看

RESTful是指基于REST(Representational State Transfer,表现层状态转移)架构风格的Web服务。REST是一种设计原则和架构风格,而不是标准,它用于指导如何构建易于交互、高效、可扩展的网络系统。RESTful服务通常使用HTTP协议的标准方法来处理网络上的资源。

在现今互联网时代,Web服务已经成为了连接不同系统、平台和设备的关键桥梁。而RESTful架构风格作为一种简单而强大的设计理念,正在逐渐成为构建这些Web服务的首选方式,在做接口测试时,大家都有听说过RESTful风格的接口,那么到底什么是RESTful,以及它有哪些设计原则?

什么是RESTful?

"REST"(Representational State Transfer,表现层状态转移)是一种设计原则和架构风格,用于构建分布式系统,强调使用统一的接口和无状态通信来操作网络上的资源,"RESTful"则是基于REST原则设计的Web服务,使用HTTP协议的标准方法来实现对网络资源的操作。

1、每一个URI代表一种资源

在RESTful中,资源是系统中的任何实体或对象,每个资源都有一个唯一的URI来标识

  • json格式数据

  • text文本

  • 图片、视频等

2、资源的表示形式

客户端和服务器之间,传递资源的某种表现形式

  • 通过请求头中Content-Type来指明传给服务端的参数类型

  1. “text/plain”, “application/xml”, “text/html”,

  2. “application/json”, “image/gif”, “image/jpeg”

  3. "application/x-www-form-urlencoded"

AI写代码

  • 通过请求头中Accept来指明希望接受服务端的数据类型

Accept: application/json,application/xml;q=0.9,*/*;q=0.8
3、通过HTTP动词(请求方法)描述操作

客户端通过HTTP动词,指明对服务器端资源要进行的操作,包括GET/POST/PUT/PATCH/DELETE等

请求方法对应的操作
POSTCreate-创建
GETRead-查询
PUTUpdate/Replace-更新/替换
PATCHPartial Update/Modify-部分更新/替换
DELETEDelete-删除

RESTful设计规则

URL设计
1、URI命名

尽量使用名词复数形式,不要使用getXXX,setXXX这种动词和名词混合在一起

差的设计:

  1. /getProjects

  2. /listUsers

  3. /users

  4. /setTestcaseById?Id=66

好的设计:

  1. /projects

  2. /users

2、过滤条件

比如/projects返回项目信息,如果项目信息过多,服务端不可能将所有的数据全部返回给前端,一般我们会加上过滤条件​​​​​​​

  1. ?limit=10 :指定返回记录的数量

  2. ?offset=10 :指定返回记录的开始位置

  3. ?page=2&size=10 :指定第几页和每页的数据条数

  4. ?sort=name :指定返回结果按照哪个属性排序,以及排序顺序

3、API版本

在URL中呈现版本号:

  1. http://api.lemon.site/app/0.1/

  2. http://api.lemon.site/app/0.2/

  3. http://api.lemon.site/app/1.1/

也可在请求头中呈现:​​​​​​​

  1. Accept: application/vnd.example.v0.2+json

  2. Accept: application/vnd.example+json;version=1.1

请求方法

常见的HTTP请求方法有下面四个(括号里是对应的SQL命令)​​​​​​​

  1. GET(SELECT) :从服务器获取资源(一项或多项)

  2. POST(CREATE) :在服务器新建一个资源

  3. PUT(UPDATE) :在服务器更新资源(客户端提供改变后的完整资源)

  4. DELETE(DELETE) :从服务器删除资源

还有三个不常用的HTTP动词:​​​​​​​

  1. PATCH(UPDATE WHERE) :在服务器部分更新(更新)资源(客户端提供改变的属性)

  2. HEAD :获取资源的元数据

  3. OPTIONS :获取关于资源的哪些属性是客户端可以改变的信息

比如:​​​​​​​

  1. GET /projects # 获取所有项目信息

  2. POST /projects # 创建一个新项目

  3. GET /projects/6 # 获取ID为6的项目信息

  4. PUT /projects/6 # 更新ID为6的项目信息(全更新)

  5. PATCH /projects/6 # 更新ID为6的项目信息(部分更新)

  6. DELETE /projects/6 # 删除ID为6的项目

  7. GET /projects/6/interfaces # 获取ID为6的项目信息中所有的接口信息

  8. GET /projects/6/interfaces/1 # 获取ID为6的项目信息中ID为1的接口信息

状态码​​​​​​​
  1. 200 OK - [GET]:服务器成功返回用户请求的数据

  2. 201 CREATED - [POST/PUT/PATCH]:用户新建或修改数据成功

  3. 204 NO CONTENT - [DELETE]:用户删除数据成功

  4. 400 INVALID REQUEST - [POST/PUT/PATCH]:用户请求有误(请求参数有误)

  5. 401 Unauthorized - [*]:表示用户没有权限(令牌、用户名、密码错误)

  6. 403 Forbidden - [*] 表示用户得到授权(与401错误相对),但是访问是被禁止的

  7. 404 NOT FOUND - [*]:用户请求的路径不存在

  8. 500 INTERNAL SERVER ERROR - [*]:服务器发生错误

感谢每一个认真阅读我文章的人,礼尚往来总是要有的,虽然不是什么很值钱的东西,如果你用得到的话可以直接拿走:

这些资料,对于【软件测试】的朋友来说应该是最全面最完整的备战仓库,这个仓库也陪伴上万个测试工程师们走过最艰难的路程,希望也能帮助到你!有需要的小伙伴可以点击下方小卡片领取

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/10 3:50:19

旧物改造灵感库,核心功能,分享旧物改造案例,如塑料瓶做花盆,旧衣服改围裙等,支持搜索改造类型,上传自己的作品,应用场景,喜欢动手的中老年人找改造灵感,废物利用省钱又环保。

旧物改造灵感库 - 创新设计梦工场我将设计一个适合中老年人使用的旧物改造灵感库,具有大字体、简洁界面和直观操作流程。设计思路- 采用温暖环保的绿色为主色调- 大按钮和清晰导航方便操作- 卡片式布局展示改造案例- 支持搜索、筛选和上传功能- 响应式设计适配不同设…

作者头像 李华
网站建设 2026/6/10 16:49:21

springboot二手车交易管理系统的设计与实现_e732y0jh-

目录已开发项目效果实现截图开发技术系统开发工具:核心代码参考示例1.建立用户稀疏矩阵,用于用户相似度计算【相似度矩阵】2.计算目标用户与其他用户的相似度系统测试总结源码文档获取/同行可拿货,招校园代理 :文章底部获取博主联系方式&…

作者头像 李华
网站建设 2026/6/10 3:46:13

基于php的智慧农业信息交流论坛系统(源码+lw+部署文档+讲解等)

课题介绍本课题聚焦智慧农业发展背景下农户、农技人员的信息交流需求,设计实现一套基于PHP技术的智慧农业信息交流论坛系统。当前农业领域存在技术信息分散、产销对接不畅、农户交流渠道有限等问题,制约农业现代化发展。系统采用“PHP(Larave…

作者头像 李华
网站建设 2026/6/10 15:40:51

Tasmota设备高效节能配置指南:从入门到精通的完整方案

Tasmota设备高效节能配置指南:从入门到精通的完整方案 【免费下载链接】Tasmota arendst/Tasmota: Tasmota 是一款为 ESP8266 和 ESP32 等微控制器设计的开源固件,能够将廉价的WiFi模块转换为智能设备,支持MQTT和其他通信协议,广泛…

作者头像 李华