静态的 Swagger 们跟不上频繁变更的代码
“为什么改了这个没告诉我”,“实际功能和文档上说的不一样啊”。这些话大家做开发的想必耳朵都听出老茧了。真不是故意的,有时候任务比较急,就先改了代码,想着以后再同步文档,然后就给忘了。项目更新又全靠社交软件通知,人一多难免有一两个没及时沟通到的。确实给合作的小伙伴带来麻烦,但说实话开 发也挺委屈的。
这些问题产生的主要原因是,当前大部分研发团队的工作流程是这样的:
旧协作模式
这种模式带来的问题是: 1. Swagger ,postman ,MockJS 只能完成软件研发流程中某个环节的功能,完成接口设计,文档编写,调试,测试验证等工作需要使用好几个工具; 2.更麻烦的是这些工具数据格式不互通,无法互相导入,造成用 Swagger 定义和编写完成接口后,在 Postman, MockJS , Jmeter 等工具还要再去手动填写一遍才能开始工作,增加了无意义的工作量。 3.沟通成本总是被忽略不计,但实际上不仅占据了很大的时间,各种沟通不及时、沟通不到位还非常让人心累。 4.老板的需求来得急,老板的需求变得快,各种代码修改和变更难以及时通知和同步到团队成员手中。
抱怨当然政治正确,但有啥用,该加的班还是要加。那么有什么办法可以解决这个问题吗?
有的。
换个工具。
低成本做长期主义的事情
我为大家提供的解决方案是一款国内的生产力工具—— Apifox 。
作为一款研发全流程,接口全周期的生产力工具,这款软件真正完成了数据流的打通,在一个软件上就能实现接口设计—接口文档—接口调试—接口修改—接口 mock —接口测试—接口自动化—接口迭代的工作流闭环; 后端,前端,测试各个角色既能各取所需,又能协同合作。
Apifo
x 上的协作流程是这样的&