2016 年:SwaggerHub 年度回顾

  2017 年 1 月 5 日

SwaggerHub 团队在 2016 年初的目标是改变团队使用 Swagger 设计、构建和记录 API 的方式。 那时,该工具看起来大不相同,我们只向一小部分开发团队介绍了 SwaggerHub 平台。 看到 SwaggerHub 从一个基本概念发展成为一个成熟的平台,现在被世界各地的数千名开发人员使用,这真是一段了不起的旅程。 当我们开启 2017 年之际,我们想回顾一下 2016 年的一些重大新闻。

帮助数千个开发团队使用 Swagger 构建出色的 API

在 2016 年,我们看到各种规模的团队开始使用 SwaggerHub。这些团队在各种行业的组织中工作,包括软件开发、金融科技、医疗、电子商务、餐饮服务、娱乐等等。 我们的许多用户来到 SwaggerHub 是因为他们是 Swagger 的新手,并且希望遵循设计优先的工作流程来构建他们的 API。其他人则有围绕使用 Swagger 记录现有 API 的特定需求,并且需要一个平台来安全地托管他们的 Swagger 定义并在 API 设计人员、开发人员和技术作家团队之间进行协作。 自 2015 年 11 月首次发布以来,仅仅一年多的时间,SwaggerHub 已经支持了超过 15,000 名开发人员,托管了超过 18,000 个私有和公共 API。 

新工具和改进的功能

倾听用户的意见始终是一项具有教育意义的工作。我们已经考虑了您的反馈,并致力于开发一些强大的新功能,以优化您的 API 工作流程。

API 开发的协作方法

为了满足提供有利于协作的环境的需求,SwaggerHub 添加了更好地支持协作工作流程的功能。现在,用户可以创建组织和团队,以更好地管理其组织资产。我们还优化了我们的用户界面,其中包含一个用于 API 的内置目录,该目录有助于在安全灵活的环境中管理和使用关键 API。      SwaggerHub 使用新的比较和合并功能,加强了其 API 文档工作流程。这允许用户精确控制哪些更改被添加到 API 中,哪些更改不被添加,从而使协作成为一个更加结构化和定义明确的过程。 再加上通过SwaggerHub 评论进行实时团队交互,协作是 SwaggerHub 的核心重点。 了解更多: 使用 SwaggerHub 进行 API 协作

API 可以使用一些源代码管理

虽然 SwaggerHub 非常适合设计、开发、记录和托管 API,但我们认识到需要将 API 连接到组织的软件开发工作流程中。源代码管理已成为存储软件和代码的实际平台。 今年,SwaggerHub 团队在流行的源代码控制主机(如 GitHub、Bitbucket 和 GitLab)中添加了直接集成。通过这些集成,SwaggerHub 允许用户将其 API 定义和代码推送生成到他们喜欢的存储库中。现在,无需在您的工作流程中添加其他层即可将您的 API 纳入您的发布周期中。       了解更多: 将您的 API 与 GitHub、GitLab 和 Bitbucket 同步

继续模拟

当团队能够看到 API 的行为方式时,API 的设计和记录会变得更加容易。随着 SwaggerHub 的自动模拟功能的开发,API 设计人员和开发人员可以在任何实际代码实现之前开始使用 API。模拟服务器直接从您的 API 后端的 UI 生成,让您针对应用程序调用测试 API 的操作和响应,以便迭代 API 的界面。      了解更多: 在 SwaggerHub 中引入自动模拟

无服务器部署,无需头疼

开发人员体验、安全性以及监控都是成功 API 的重要因素,这些只是将 API 部署到 API 管理平台的一些好处。我们开发了可以连接到您在 Microsoft AzureAmazon API Gateway 上的 API 管理解决方案的集成。我们还通过与 Amazon Lambda 的集成来支持围绕无服务器部署的日益增长的势头,这让您可以在 API Gateway 上创建 Lambda 函数,而无需执行任何繁琐的管道和配置,否则这些管道和配置可能会进入 API 部署中。这样,您就可以在 SwaggerHub 中的单一事实来源中处理所有 API 部署需求。 了解更多: 

将 SwaggerHub 带入巡回展

我们很自豪能够在 2016 年赞助并参加了一些令人难以置信的活动。我们有机会举办研讨会、进行演示,并与世界各地数千名使用 API 的人联系。这些会议包括:丹佛的 GlueCon、波士顿的 APIStrat、拉斯维加斯的 AWS:Reinvent 以及法国巴黎的 APIDays。 

欢迎 API 专家来到 SmartBear 总部

SwaggerHub 团队汇集了 API 行业中的杰出思想领袖,讨论他们如何处理其 API 战略。小组由以下人员组成:  讨论的一些主题是从 SOAP 到 REST 的过渡、组织应如何处理其 API 管理以及改进 API 采用的最佳实践。 您可以在此处观看小组讨论: 专家小组:为 2017 年制定 API 战略 [视频]

继续为 API 成功构建新资源

我们通过免费的、每两周一次的在线培训网络研讨会,进一步兑现了我们对您在 SwaggerHub 上 API 成功的承诺。这些网络研讨会旨在引导您了解 SwaggerHub 的各种功能,这些功能可以加速您 API 生命周期中的各个阶段。您可以在此处找到有关该系列的更多信息。此外,我们还添加了新的教程,包括: 并且我们已邀请多位 API 专家在SwaggerHub 博客上分享他们的知识。您可以通过在 Twitter 上关注 SwaggerHub 来了解我们的最新消息和资源:@SwaggerHub。我们很荣幸也很兴奋看到如此多的工程师和组织信任我们来解决他们的 API 方案,我们希望在新的一年里提供更好的功能和改进。

API 经济以及如何优化您组织的 Swagger API 工作流程

将 API 视为业务目标的重要驱动力是一个相当新的发展,公司现在已经开始在他们的 API 战略上投入巨资。与此同时,API 描述格式(如 Swagger)的采用也呈爆炸式增长,这些格式有助于简化开发并推动组织 API 的采用。在我们即将举行的网络研讨会API 经济以及如何优化您组织的 Swagger API 工作流程中,我们将逐步讲解如何理解组织应如何考虑其 API 战略,以及像 Swagger 这样的 API 描述格式如何提供帮助。我们将为建立 API 生命周期的工作流程提供最佳实践,并向您介绍您的团队如何使用 SwaggerHub 在 API 的设计、文档和开发上进行协作。涵盖的一些主题包括:
  • 什么是 API 战略?
  • API 提供的一些商业机会是什么?
  • 成功的 API 战略的要求是什么?
  • 确定正确的 API 开发方法
  • 使用 SwaggerHub 优化 API 工作流程
网络研讨会时间为 1 月 25 日星期三美国东部时间下午 1:00。 立即注册!