过去几天,我在 dev.to 上记录了我构建高度自动化的 LiveAPI 的故事。
我邀请您考虑通过以下链接阅读我以前的文章:
这个 API 客户端有一个出色的登陆页面技巧思考 LiveAPI 有何不同(与 Swagger 等不同) - DEV 社区仔细查看通过 LiveAPI 的 AI 生成的 API 文档规模如何改变一切 - LiveAPI 视角对于 LiveAPI - 每一天都是一段小生命今天对于我的团队来说,在工程进展方面是比较平淡的一天。
我们现在正在努力解决一些问题:
在 LiveAPI 订阅流程中正确区分月度和年度计划使用私有 LiveAPI 运行器修复错误。使用 LiveAPI 运行器,您可以在服务器基础架构内运行大部分 git 克隆、语言/框架检测、相关文件选择。只有生成文档所需的最少文件才会发送到 LiveAPI 后端。改进工作状态跟踪。现在,您将在 LiveAPI 的修订部分内获得包含有价值信息的详细日志,例如传输到 LiveAPI 后端的文件。
虽然以上 3 项目前都是“正在进行”的事情 - 我们希望很快完成 - 但今天在 LiveAPI 登陆页面上进行了一项新开发的产品电离。

ROI 计算的思路
首先,我碰巧认为需要经过计算才能说服开发人员或 CTO 购买 LiveAPI 的吸引力太弱了。
我希望让 LiveAPI 变得如此出色、高度自动化、超级友好和实用——以至于部署 LiveAPI 来改善工程组织的情况成为一个不需思考的决定。
尽管如此,我还是认识到拥有 ROI 页面可能会有所帮助,原因如下:
玩具模型让我们思考得更深入:在科学和数学领域,我们通常使用理想模型或玩具模型。我们有时会过度简化或简化不足,并努力提出有用的模型。特别是对于像我们这样的团队来说,我们在这个领域相对较新,正式列出大多数人潜意识中判断 LiveAPI 成功的因素可能是一个好主意。ROI 计算器有助于吸引组织中的非技术人员:可以想象许多情况 - 有人必须基于纯数字和推理来评估 LiveAPI - 例如大型公司的采购部门。在这里,产品的购买者和用户是不同的。因此,为了让非技术用户清楚地了解实用性,拥有 ROI 计算器是有意义的。LiveAPI ROI 计算器 - 第 1 遍
首次访问时,LiveAPI 计算器将如下所示:

或者,在移动设备上如下图所示:

读者可以使用**3 个杠杆**来弄清楚传递的值如何随着各种输入配置而变化。
可以定义:
存储库数量:LiveAPI 中最重要的方面是 - 您计划连接多少个存储库?目前,我们在 LiveAPI 中支持 github、gitlab、自托管 gitlab、bitbucket 和公共 git 存储库 - 我们也很乐意支持任何其他 git 提供商。活跃用户数:LiveAPI 的价值还取决于你希望吸引多少用户平均小时工资:本质上 - 我们将通过一些基本计算来证明我们可以通过 LiveAPI 节省多少熟练工程师/项目经理/经理的工作时间两种储蓄类型
在计算器中,您会注意到 LiveAPI 为您提供两种类型的福利/节省:
设置工作:作为 Swagger 的替代方案,我们付出了巨大的努力来减少将新存储库加入 LiveAPI 的负担。在 LiveAPI 中,连接 10 个存储库所需的工作量 - 可能只需 10 次点击(也可以减少)。考虑到异构语言/框架/配置存储库 - 在我们的竞争对手中,工程师可能需要长达一周的时间才能获得真正优秀的 API 文档管道。相比之下,LiveAPI 集成几乎是即时的。
持续节省:在日常工作中,我们会通过估算每位员工每天可以节省多少时间来考虑 LiveAPI 的价值。例如,开发新功能的工程师每天可能会与我们的文档互动十几次。这可能会节省他们在源代码中寻找 API、尝试编写集成代码以使用 API 等的时间。我们的估计是,每次这样的努力都可以节省大约 10 分钟,而典型的开发人员每天会多次进行这样的努力。随着人数的增加,节省的时间/金钱确实会累积起来。
从投资回报率计算器中得到的经验教训
假设每月在 LiveAPI 上投资约 20 美元,一家典型的初创公司可以节省约 2 万美元的熟练员工时间。随着组织中连接的存储库数量的增加,LiveAPI 对组织的价值越来越大。随着活跃用户数量的增加,LiveAPI 对组织来说变得更加有价值。这些是 LiveAPI ROI 计算器为我们得出的明确结论。我鼓励您了解 LiveAPI 并与您的团队一起尝试。前 7 天免费 - 您可以充分利用所有功能。