最近的一些年经常在内网环境下进行开发工作,尤其是比较敏感的单位或者组织是有严格规定不能使用哪些软件或者是不能访问外网的。
但开发工作需要的各种软件工具又因为一些营销策略而要联网激活,这就和组织单位的要求相悖了。于是就萌发了开发内网局域网软件工具,SmartApi作为首款针对局域网或者内网的API调试开发工具很适应这些使用场景要求,不需要链接外网,所有功能在内网即可完成,并且小巧精简,如有服务端要求可私信联系
笔者搞移动开发十多年了,接口、数据、数据模型、以及数据边界值的处理是需要团队协作解决,而这方面恰恰是总容易导致bug的地方,bug难发现,不好复现,复现后因为业务数据流链条过长从而难修复。
而一款好用的api调试工具对于后端、前端、测试都是必须必的掌握熟练使用,Api就像人体的血管,里面有各种成分的数据,需要api工具进行可视化的解析分析然后给后端、前端、测试提供直观的结果反馈。就好像去医院做血常规一样,先查看一下血管里的血液成分数量比例,基本能反应一个人的表征健康情况。
而市面上的诸多工具如最早的postman、eolink、以及近几年的postapi和foxapi等等都把使用场景复杂化,使用流程多元化。虽然能用但却不好用,每次打开一个都能导致电脑性能下降一大截。笔者实在是忍了很久,不想再忍了,于是自己自研了这款SmarApi开发工具软件单机版本。精炼、小巧、且功能完整。很适合开发和测试使用。
归纳四大功能项进行如下说明
四大功能项
1、发起请求
1)接口名称
2)环境编辑和选择
3)URL完整展示
4)URL编辑和访问方式选择
5)请求参数编辑
2、请求响应
1)实时响应:
2)请求(request)
3)响应头
4)Cookie
5)成功示例
6)异常示例
7)响应码
8)响应时间
9)响应耗时
10)响应数据大小
11)响应网络地址
12)下载响应数据
3、内网局域网PDF在线分享文档(可下载PDF文件)
保存接口后,点击分享文档即可看到分享文档面板
复制局域网分享地址即可查看PDF在线文档(建议协作方下载PDF文档备用)
下面是一个在浏览器查看的在线PDF接口文档示例图:
4、本地化可编辑Mock数据解决方案-尤其是对于数据边界情况可调式
请求和响应是分析问题解析问题,那mock的功能就是能还原复现问题了,尤其是那些数据边界问题,比如int型和string类型混用、字符串长度的边界对UI效果的影响、空值情况产生的意外处理等等类似的数据和界面的冲突问题;如果是传统的方式那就是注入数据了,注入方式虽然也能解决问题,但做过的人都知道这样方式有点不够优雅,而且有时候出现污染问题等等。使用mock就没这样的问题了,直接修改响应的数据模型结构,数据值的大小,数据字段的类型等等。而且是通过本地http访问方式进行拉取数据的,方便、干净、整洁、快速等等优势。
SmartApi结合多年的实际开发经验,结合了mock.js开源库的特点。集成一起进行编辑,调试、使用为一体化。
1、只需要在编辑面板里填写mock数据模型语法,即可在右侧预览面板查看到示例数据效果,
2、建立本地mock服务只需要点击提交按钮即可。
3、然后复制后面的相对路径和url变量表达式,粘贴到url编辑框里,在选择mock环境,即可在URL预览里查看到完整的URL路径,点击发送即可获取到相应数据。如想验证也容易,在浏览器里里粘贴完整url路径即可访问到对应的数据
结果如下:
下面是几个mock的小例子:
列表
{
"list|10": [
{
"price": "@float(0, 100, 2, 4)",
"isRead": "@boolean",
"ctitle": "@ctitle",
"csentence": "@csentence",
"title": "@title",
"content": "@sentence",
"author": "@cname",
"author2": "@name",
"img": "@image",
"lookCount": "@integer(0,10000)"
}
]
}
标题
{
"title1": "@title(2,4)",
"ctitle2": "@ctitle(3,5)"
}
等等。就不一一展示了
后面还有一个“…”的,可以查看mock更加具体的使用说明
推荐理由
postman在国内使用已经越来越困难:
1、登录问题严重
2、Mock功能服务基本没法使用
3、版本更新功能已很匮乏
4、某些外力因素导致postman以后能否使用风险较大
出于以上考虑因此笔者自己开发了一款api调试开发工具SmartApi,满足基本日常开发调试api需求