rap2换yapi的心路历程

一.背景

1.首先公司原先用的是swagger,而且是手写yaml格式,甚至于最初还有word。作为一只node中间层,偷懒成性猿,上接前端,后连java后端,python数据组,翻个swagger,一天就过去了,万万不能接受。开始了一波骚操作,找寻各种能替换个方式。

  1. 一顿操作后选定了rap2,毕竟是阿里家的,怎么着感觉会靠谱些,又有全局搜索功能,也有mock。好了好了,我承认是因为界面风格(不是最新版,最新版emmm)。

  2. 生命不止,作死不止。rap2不支持导入,怎么办?去官方提了issue,并不打算解决。已经和老大说好要换,吹出去的牛总要实现吧。先部署了一套在测试环境,徒手撸代码,写了套swagger导入,postman导入,直接操作rap2数据库。(我可真是个机灵鬼,手动滑稽)

4.To Young To Simply 开始使用感觉哪哪都漂亮,哪哪都棒,然后当接口全部导入后。首次进入会查询很久,看了源码发现一次查询直接把所有的接口详情全部都查完了,敢情直接查了个整库。受不了受不了!!!同事修改的源码,改成点击接口,查询详情。react无能,上当了,改完后,有bug改不来,修改内容,要点击两次才会刷新。最最要吐槽的是,不是主页刷新就会404!

5.有了上述吐槽,却还是用了两月。毕竟比写swagger总是强多了。懒汉换东西总要有契机,某天突然登录不上,验证码错误。嘿哟,这宝宝又没改怎么会坏?到底是年轻,想说要不要用最新的版本试试。(大大的失误,没改代码不应该这样操作,引以为戒)又部署了一版新的,还是不行。这可如何是好,慌的一匹?后来发现是redis,别问,问就是懒鬼用了测试环境同个redis,数据组猿把redis写满了。(鬼知道他们在做啥骚操作。)

6.普通人恢复回去就好了,但是作死党不存在。有一就有二,下次坏了咋办?一溜思索,找了运维要了内网服务器,这总没人捣乱了吧。是不是以为要迁移了?新版的rap2依旧是一次加载,还是要改成单个加载,然而之前改的同事已经离职(我不知道,我不会!!!)改回去,是不可能改回去的,用新不用旧,回去依旧又bug。

7.想换的苗头已经变成窜天大火,又是一顿乱搜,这次选上了yapi。之前用rap2,用的太急都没对比考虑。这次已经不是两月前的小白了。一通对比,还看了各种对比文章。先去yapi官网试了一通,看了github,嘿嘿,熟悉的js一套,rap2也是,只是ts,就看了一丢丢,并没有实践好吧。

二.优势

支持json/swagger/postman导入
可以直接调用接口,替代了postman功能,能选择测试环境
有全局搜索功能

三.小不习惯

预览里没法直接展示json,只有表格解释。
没有测试人员选项,只能给测试开发者权限,并不希望他们改我接口,呀喂!

附上链接帮助下坑里的同学
yapi
YAPI环境搭建
rap2sevice 包含swagger/postman转rap2,rap2转swagger
Rap2导出swagger2格式json,方便转入yapi
rap2官网

你可能感兴趣的:(rap2换yapi的心路历程)