标题中提到的“颜值低”是因为在之前的帖子( https://www.v2ex.com/t/952265?p=3 )中,我对自己的产品的颜值过于自信,结果被很多人吐槽。所以这次我想委婉一些,降低颜值期望。
发帖的主要原因是,我发现很多用户并不知道 showdoc 实际上还有一个独立的客户端工具 runapi ,我想专门开一个帖子分享一下。
尤其是当我听到一些老用户说他们觉得 showdoc 没有调试接口的功能而放弃使用时,我觉得非常可惜。因为和“一开始就放弃 showdoc”的用户不同,那些想要调试接口的老用户其实并不难争取到。最令人遗憾的不是一开始就放弃,而是错过了本可以做到的。
我想可能是我的宣传不够到位,产品引导不够好,文章宣传也不够,导致很多人不知道可以使用 runapi 来调试接口,并且自动生成文档到 showdoc 。
postman 可以说是接口调试工具的鼻祖和天花板了。目前大部分后端程序员都知道 postman ,这为 runapi 的市场教育做了铺垫,我不需要太仔细介绍 runapi 的功能,就说它是类似 postman 的接口调试工具就可以了。 runapi 跟其他竞品(如 postman 、apifox 、apipost 等)最大的不同之处在于它与 showdoc 的联动。在调试完接口后,runapi 可以直接将生成的文档上传到 showdoc 中。对于后端程序员来说,这非常方便——只需要开发完接口,上传到测试环境,然后将生成的 showdoc 接口文档直接分享给前端对接人员即可。 这两个工具分别解决了接口调试和 IT 团队文档的场景,协同效率非常高。许多 showdoc 用户都非常喜欢这一点。 但这也客观上限制了 runapi 的使用范围,它基本上只在 showdoc 用户群体中使用,好像只是 showdoc 的一个辅助工具,而不像 postman 等独立运作的品牌。我不确定是否要将 runapi 独立运营,但就目前而言,似乎还无法摆脱 showdoc 。所以在宣传 runapi 时,往往会同时宣传 showdoc 。
下面就贴一份比较官方口吻的宣传文吧。
runapi 是一个以接口为核心的开发测试工具(功能上类似 postman ), 包含接口测试/自动流程测试/Mock 数据/项目协作等功能。
它和 showdoc( https://www.showdoc.com.cn/help )相辅相成:showdoc 以文档为核心,侧重文档编写和知识资料沉淀。而 runapi 则以接口为核心,包含接口测试、管理、Mock 数据、自动化流程测试等一系列功能。同时它将自动生成文档到 showdoc ,无须再手动编写文档,释放生产力;共用 showdoc 的团队管理机制,很好地实现接口的自动化和多人协作。相信使用 showdoc + runapi 这两个工具组合,能够极大地提高 IT 团队的效率。
https://www.showdoc.com.cn/runapi
这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。
V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。
V2EX is a community of developers, designers and creative people.