https://www.toutiao.com/article/7254820515754361359
项目地址
https://github.com/Kong/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/video/
首先我们打开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