作为一名后端开发者,我们经常会使用API工具来调试接口,之前一直使用的Postman,用多了感觉它有点不够轻量级,有时候打开也比较慢。最近发现了一款轻量级的开源API工具Insomnia,界面挺炫酷,功能也很实用,推荐给大家!
Insomnia简介
Insomnia是一款开源、跨平台的API客户端工具,可以支持多种网络请求的调试,比如GraphQL、REST、WebSockets和gRPC,目前在Github上已有29K
的Star。
下面是它的一张使用效果图,界面还是挺炫酷的。
安装
Insomnia的安装是非常简单的,我们可以去它的官网下载,下载完成后双击文件即可运行,下载地址:https://insomnia.rest/download
使用
接下来我们将通过Insomnia来调试下我的电商实战项目mall的接口,这里还是简单介绍下mall项目吧,mall项目是一套基于 SpringBoot + Vue + uni-app 的电商系统,目前在Github已有
60K的Star
,包括前台商城项目和后台管理系统,能支持完整的订单流程!涵盖商品、订单、购物车、权限、优惠券、会员等功能,功能很强大!
- 项目地址:https://github.com/macrozheng/mall
- 文档网站:https://www.macrozheng.com
- 首先我们打开Insomnia,然后点击加号创建一个工程;
- 然后启动下mall项目,打开mall项目的Swagger界面,我们将通过导入的方式往Insomnia中导入接口,mall项目Swagger接口文档地址:http://localhost:8080/swagger-ui/
- 之后我们选择导入按钮,输入上图中圈出的url地址来导入接口;
- 导入成功后,在Insomnia的项目中就会出现一个集合了;
- 点击这个导入的集合,我们就可以看到导入的接口了;
- 在调试这些接口之前,我们还需要设置下环境变量,这里直接使用Swagger的默认环境变量就可以了;
- 之后我们还需要对这个环境变量进行设置,主要是把
base_path
设置为空;
- 在我们访问接口之前,需要设置下
Authorization
请求头,对于不需要登录认证的接口,比如说登录接口,我们需要在访问前去除它;
- 之后我们在请求参数中填入信息,就可以调试接口了,这里的请求参数格式Insomnia会自动填写,还是挺方便的;
- 如果你想访问需要登录认证的接口,比如品牌列表接口的话,可以在环境变量中添加一个
api_key
的属性,填入登录接口访问的token;
- 这样我们就可以成功访问需要登录认证的接口了。
设置
对于Insomnia来说,还有一些常用的设置,这里简单介绍下。
- 比如我们如果想修改工具的字体大小,可以点击左下角的设置按钮,然后修改即可;
- 如果你想修改下Insomnia的主题的话,也可以在设置里完成,Insomnia支持多达18种主题,还是很炫酷的。
总结
Insomnia确实是一款界面炫酷、功能强大的API管理功能,对比Postman它更加轻量级,其实有时候我们选择工具时,并不需要它功能很多,简单、够用、看着舒心就好。
项目地址
https://github.com/Kong/insomnia