2018年是API领域具有变革性的一年。
OpenAPI 规范 (OAS) 等开放标准已获得广泛增长和采用，API工具领域的领导者，如AWS API 网关和SwaggerHub也已扩展对OAS 3.0的支持。我们还看到了供应商整合的持续趋势，包括Salesforce于2019年3月以64亿美元收购Mulesoft，以及Broadcom于2018年7月以189亿美元收购CA Technologies。
在Smartbear，我们很高兴为API工具带来多项新进展，包括发布Swagger Inspector以探索和生成现有API的OAS 3.0定义，发布API标准化以大规模强制执行API标准，SwaggerHub中支持OAS 3.0代码生成，以及在ReadyAPI测试平台中添加原生Jenkins插件以支持我们用户不断演进的工作流。
2018年，我们也看到软件团队增加了对新平台的投资，以帮助促进其API开发。如今，超过20万API提供商正在利用SwaggerHub，通过OpenAPI规范标准化其API设计并扩展其API开发。我们有机会听取了这些团队中几位领导者的故事，他们分享了通过采用SwaggerHub如何支持惊人增长或现代化其API工作流的经验。
随着新年的到来，我们想借用其中一些故事，并强调更多软件团队在2019年投资API开发平台的一些原因。
1. 标准化是规模化的关键
我们反复听到在API目录不断增长的组织中工作的API架构师提到，缺乏标准化是其团队时间和资源的最大压力之一。
对于大多数团队来说，在其API中设置和强制执行标准的过程完全是手动的。随着API和利益相关者数量的增长，这个过程通常涉及多个团队或团队成员，并且变得更加痛苦。
这是Viasat团队在2017年采用SwaggerHub时面临的问题。据Viasat软件工程师罗杰·普伦格尔所述：
“我们有很多接口使用相同类型的数据，我们一直在努力解决数据在不同接口之间外观变化的问题。问题在于，在一个API中它被称为一回事，在另一个API中被称为另一回事，在再一个API中又被称为第三回事。通过系统跟踪数据变得越来越混乱。”
在SwaggerHub中，Viasat发现能够使用名为域的可复用组件来标准化数据模型。通过域，他们可以创建可在API之间使用的通用模型，而无需额外的强制执行。
“我们发现了一种在SwaggerHub中使用域的方法，可以拥有一个我们可以在所有API中使用的通用基本数据结构。”
2. 消除沟通障碍
在沟通渠道比以往任何时候都多的时代，您可能会认为协作将是一个完全流程化的过程。不幸的是，我们经常从新的SwaggerHub用户那里听到，分散的沟通渠道——Slack消息、电子邮件、JIRA评论——可能导致对API生命周期中所做更改缺乏可见性。
在API开发中，特别是在规划和设计的早期阶段，拥有一个标准化的格式来沟通变更、提出问题和提供反馈，对于避免下游问题至关重要。当您跨团队和跨地域工作时，这一点变得更加重要。
这是我们从Bonotel首席信息官斯科特·黑斯廷斯那里听到的：
“SwaggerHub极大地改善了我们内部团队与外部合作伙伴之间在API开发方面的沟通。这很关键，因为我们内部不进行大量的API开发——大部分工作都是通过我们的合作伙伴完成的，他们也相互协作。SwaggerHub作为一个集中式主机，促进了所有参与方之间的协作，使整个过程非常高效、直观和无缝。”
协作是否成为您当前API开发工作流中的障碍？了解Bonotel如何在SwaggerHub中简化协作。
3. 设计优先的转变
2018年，我们看到越来越多的组织采纳了API开发的“设计优先”方法。在2018年10月进行的一项针对3000多家API提供商的调查中（我们将在2019年1月正式发布），我们发现近一半的组织在开发中的至少部分API上遵循设计优先的方法。
转向设计优先的方法正在帮助团队在API开发早期达成一致，从而减少错误、加快迭代并实现并行开发。Realpage移动开发总监特拉维斯·科尼格在SmartBear用户大会SmartBear Connect上发表关于《现代化企业API开发流程》的演讲时讨论了这一点。
正如特拉维斯所解释的：
“SwaggerHub使我们能够以以前不可能的方式执行项目，从而使我们在整个生命周期中的许多团队能够更并行地执行并加快开发速度”
4. 集中式API发现
内部发现是一个经常被忽视的挑战，直到多个团队和利益相关者参与到API的开发和维护中。与发现相关的常见问题之一是团队如何找到并使用API的最新版本。当团队依赖像Github这样的源代码管理主机不仅存储源代码，还存储API定义时，这种情况经常发生。
这就是为什么我们在SwaggerHub中构建了支持OAS定义和API文档托管和版本控制的功能。SwaggerHub可以作为团队探索现有API的中央存储库，并供开发团队根据不同角色（API设计者和使用者）为正确的利益相关者分配访问权限。当SwaggerHub中进行更改时，这些更改也会与您的Github存储库同步，使SwaggerHub成为您的API文档的真实来源。
Evosus, Inc.架构师史蒂夫·霍金斯解释了如何在SwaggerHub中改进API发现有助于降低成本和精力：
“SwaggerHub为我们API的开发和展示提供了一个有效的门户。我们将SwaggerHub作为我们API消费者的参考文档。我们了解到，实现我们API的开发人员正在使用代码生成选项来减少他们的工作量和成本。”
5. 超越开源工具
作为开源Swagger工具背后的公司，我们理解开源的力量，特别是对于那些试图快速扩展并希望消除技术障碍的组织。但随着您的API程序增长并变得更加复杂，对支持您工作流的工具的需求变得清晰。
这是Viasat系统工程师辛迪·雷克尔在SmartBear Connect 2018会议上，她的演讲《通过设计优先方法支持系统快速增长》中讨论的内容。
“在‘规模扩张’阶段，您行动迅速，努力将一切整合起来。当您通过规模扩张阶段后，您真的需要在业务运作方式上确定一些事情。就转向SwaggerHub而言，这对我们来说是一个优势。Swagger开源版是您在SwaggerHub中获得的基础，但我总是被问到，为什么我应该转向SwaggerHub？我可以告诉您，随着您的团队发展，您的产品发展，您的市场发展，这是解决问题的方法。”
拥有支持您成长的工具将有助于打破壁垒、改善协作，并减少阻碍构建可扩展API程序的摩擦。而且，由于SwaggerHub将Swagger Editor、Swagger UI和Swagger Codegen等工具的功能整合到一个中央平台中，因此迁移到SwaggerHub对您的团队来说将是一个无缝的过程。
准备好迎接2019年了吗？
我们很高兴看到超过20万SwaggerHub用户和数百万Swagger开源用户在2019年取得的所有伟大成就。我们将继续发展我们的工具，以满足现代API团队的需求，构建新功能以帮助您完成工作，并与您信任的工具集成以交付高质量的API。
让SwaggerHub成为您2019年API之旅的一部分。点击此处立即安排演示。