规划您的 2018 年 API 战略:助您的团队取得成功的工具和资源

  2017年12月21日

SwaggerHub 旨在帮助团队重新思考 API 交付方式。

2017年,超过70,000名 API 开发者、设计师、技术文档编写者和产品经理开始使用 SwaggerHub。在此期间,我们对 API 团队如何大规模设计、文档化和交付 API 有了深入的了解。

我们还深入了解了组织在多个团队之间协作处理数百个 API 时面临的挑战。

例如以下挑战:

  • 如何确保所有相关人员都能看到 API 的变更?
  • 如何在更新和版本化 API 的同时,确保您的文档保持最新?
  • 如何确保 API 设计的一致性,并强制执行 API 构建标准?
  • 如何改进您的设计流程并采用 OpenAPI 3.0 等新标准?

今年,我们发布了多款新工具和资源,以帮助应对 API 团队面临的这些及其他挑战。我们还联系了 API 领域的行业领导者和创新者,征求他们对交付优秀 API 的看法。展望 2018 年,我们希望分享一些我们最好的资源,并回顾 SwaggerHub 的新功能,以助您的团队在新的一年里取得成功。

助团队交付优秀 API 的工具

我们在 2017 年初发布了三项新功能,旨在帮助团队更好地管理 API 设计和文档工作流程:用于设置和执行 API 样式指南的样式验证器 (Style Validator)、用于审查和合并设计变更的比较与合并 (Compare & Merge),以及用于在团队内组织 API 的项目 (Projects)。

我们还与两大领先的 API 网关:Apigee 和 IBM API Connect 发布了新的集成。

为了结束 2017 年,我们增加了对使用最新版 OpenAPI 规范(OpenAPI 3.0)设计和文档化 API 的初步支持。

规划您的 API 战略

2017 年,我们继续看到越来越多的组织采用产品管理原则来交付 API,并认识到现代“API 经济”的商业机遇。我们还看到团队越来越需要一个能够涵盖 API 整个生命周期(从规划和设计到文档、测试和部署)的战略。

以下是我们规划 API 战略的一些重要资源

来自 API 行业的洞察

在这一年里,我们有机会接触到 API 领域各个方面的专家,了解他们对 API 设计、协作以及一些世界顶尖 API 团队如何实施成功的 API 战略等广泛主题的看法。

请查看我们最受欢迎的访谈:

规划和扩展您的 API 设计流程

OpenAPI(以前称为 Swagger)等描述格式日益普及,促使人们越来越关注 API 开发的“设计优先”方法。因此,组织投入更多时间和精力来标准化其 API 设计流程并设置 API 设计要求。

通过这些资源了解如何标准化和扩展您的设计流程

通过 API 文档提升 API 开发者体验

API 文档是使用 OpenAPI 的团队最重要的用例之一,也是 Swagger UI 等工具如此受欢迎的主要原因之一。良好的文档可以帮助提高用户采纳率,减少支持咨询,并为使用您的 API 的人员带来更好的体验。

今年,我们发布了许多资源,以帮助初学者和经验丰富的 API 团队文档化他们的 API。

OpenAPI 3.0 入门

负责促进 OpenAPI 规范开发的 OpenAPI 倡议组织于 2017 年 7 月正式发布了该规范的最新版本。OpenAPI 3.0 是 Swagger 规范的下一代演进,除了正式更名外,还带来了改进和新功能,以帮助团队在其 API 的整个生命周期中利用该规范。

自发布以来,我们举办了三次培训,并发布了许多新资源和文档以供入门

2018年您还想了解哪些 API 主题?请在下方评论中分享您的问题。

© . All rights reserved.