得物API一站式协作平台探索与落地
1. 现状 API文档作为公司研发重要的数据资产,承载了公司核心的业务逻辑,随着公司业务的复杂化,软件架构微服务化,公司数字化的发展,API的研发管理成为了公司研发的最重要的一个环节,而得物目前存在两个接口文档相关的平台: 文档管理平台-YApi 基于开源的YApi平台,提供基础的API管理能力。 数据Mock平台-Mooncake Mooncake 平台为前端和客户端提供零侵入、场景化的Mock服务。 2. 面临的问题 根据行业报告显示,开发团队大概有50%的工作时间是围绕着API开展的,目前在得物的研发流程中,围绕API文档的协同工作分散在不同的工具或者平台,导致现有的API在研发协同工作中低效流转。 API文档资源利用率低 YApi作为现有的文档管理平台,过度的管控、复杂的交互和混乱的分类导致现有的文档利用率非常低。根据数据统计,大部分的使用场景为上传文档、确认文档等。 API文档质量无法保障 由于YApi文档管理平台缺乏文档的最终测试环节,导致接口在后期改动环节,并不能及时同步到文档平台,最终无法保障文档的统一性和质量。 围绕API研发流程割裂 在接口的整个研发生命周期中(设计...