OpenAPI Initiative (OAI) 专注于创建、发展和推广基于 Swagger 规范的供应商中立 API 描述格式。作为 Linux 基金会下的开源项目，OAI 致力于开发和推广 OpenAPI 规范供所有人使用。我们欢迎来自成员和非成员的贡献。

您和您的组织可以做很多事情来帮助社区。

1. 利用规范：使用 OpenAPI 规范无需支付任何费用或满足任何会员要求：GitHub | OpenAPI 规范
2. 开发规范：欢迎社区所有成员参与有关如何发展规范的讨论。找到一个适用于您项目的元问题。如果您在这里没有看到，请记录一个新问题。
3. 分享您如何使用规范。
   • 关注我们的 Twitter：@OpenApiSpec
   • 加入我们的 LinkedIn 群组：OpenAPI 规范
   • 参加您所在地区的聚会，或提供在聚会上进行演示的机会。
   • 当然，您也可以在自己的博客上分享。
4. 如果您希望直接支持该项目，请考虑让您的公司加入 OAI 成为会员。填写此表单以了解更多信息。项目章程在这里。

不确定如何开始？请阅读如何参与此处。

---

11 月 3 日

API 设计与治理 | 上午 11:00 – 下午 12:30
Matthew Reinbold，Capital One DevExchange API 卓越中心负责人
当一家公司决定将所有内容都用 API 化时会发生什么？组织可能很快就会效仿 Netflix 和亚马逊，追求微服务和面向服务的架构 (SOA)。但是，如果没有应用 Conway 定律，任何治理工作（以及由此产生的 API 程序）都将达不到预期目标。Matthew 在多个企业公司建立和发展 API 治理程序方面发挥了重要作用。在本演讲中，他将讨论有效的 API 治理以及实现它的挑战。

微服务：gRPC 还是 REST？为什么两者兼而有之？ | 上午 11:00 – 下午 12:30
Sandeep Dinesh，Google Cloud 开发者倡导者
在本演讲中，Google 的 Sandeep Dinesh 将向您展示如何构建一个 gRPC 端点，该端点可以在同一端口上智能地通过 HTTP/2 提供 gRPC 服务，同时通过 HTTP/1.1 提供 JSON/REST 服务！然后，他将逐步介绍一些基准测试和最佳实践，以便以可扩展的方式部署这些微服务。请在此处阅读更多信息

超媒体

超媒体与图：最佳拍档还是下一个 API 战场？ | 下午 1:30 – 下午 3:00
Gareth Jones，微软
我们都在想，今年是否会成为超媒体成为主流的一年？但紧随其后的是一个新的挑战者：图形形状的 API 预先定义了一个广泛的关系网络，承诺提供超媒体 API 的一些好处，但呈现了一个更熟悉的编程模型。在超媒体甚至还没有机会之前，图形是否会将其推开，或者这两种风格是否会很好地发挥作用？这种趋势是 HATEOS 涅槃的障碍还是垫脚石？
我将挑战听众考虑结合这两种方法，为超媒体的主流使用打开大门，用动态数据和行为丰富固定的图形。易变的数据和逻辑可以使用超媒体，而更基础的数据可以使用图形方法。通过这种方式，我们可以为我们的应用程序添加价值和深度，而无需我们经常期望从过渡到超媒体中获得的彻底重写。请在此处阅读更多信息

 

企业
为遗留 SOAP 服务注入新的活力 | 下午 3:05 – 下午 4:35

Darrel Miller，微软软件开发人员
现实情况是，SOAP 服务不再酷了。如今的开发人员希望与标有 REST 的 API 集成。他们希望使用描述性 URL、JSON 有效负载和熟悉的 HTTP 状态代码。但是许多企业花了 10 年时间构建 SOAP 服务，并且其中许多服务在今天仍然运行良好。重写它们将是一项巨大的工作，而收益却微乎其微。好消息是，可以在不进行重写的情况下为开发人员提供他们想要的东西。您可以利用 HTTP 的分层架构在 SOAP 服务前面放置一个外观，重用所有现有的代码，为您的服务注入新的活力，并且仍然支持愉快地发送 SOAP 消息的现有客户端应用程序。本次演讲将探讨将本地 HTTP 请求转换为 SOAP 消息并转换回本地 HTTP 响应的过程。我们将讨论哪些部分的 façade 过程可以自动化，哪些部分需要设计决策。最后，我们将探讨使用这种新的 API 风格可以获得哪些功能以及会失去哪些功能，以便您可以对 SOAP 服务的未来做出明智的决策。

大图的重大问题 | 下午 3:05 – 下午 4:35
Amber Fallon，SmartBear 软件
API 很大。比我们许多人（即使是我们行业中的人）意识到的还要大——事实上，公共 API 的总数从 2012 年的不到 7,500 个激增到 2015 年的超过 15,000 个。规模更大的公司拥有更大的 API 结构，比以往任何时候都拥有更多的依赖项和集成，而且这个数字还在增长。整个商业模式都围绕着一些行业巨头提供的 API 而形成。想象一下，像 Uber 或 Waze 这样的应用程序巨头在没有 Google 地图技术的情况下运行，或者 Netflix 与为其视频流提供支持的基础应用程序之间的重要关系——这些应用程序绝对依赖于其底层的 API。而且，每天都会出现依赖于公共 API 的新应用程序。
随着规模的扩大，随之而来的是一些挑战，例如以促进依赖 API 增长、扩展、维护 SLA 以及允许用户创建应用程序的多功能性的方式管理您的公共 API；您的 API 可能以您从未设想的方式使用。在本课程中，我将解决诸如大规模沙盒、辅助最终用户集成以及管理大型 API 可能遇到的无限数量的依赖项等挑战。

您可以降低到多低？使用 AWS Lambda、API Gateway、Elastic Beanstalk 和 3scale 降低成本和开发时间（别忘了 Swagger！） | 上午 9:05 – 上午 9:30
Erin McKean，Wordnik 创始人
超过 18,000 名开发人员拥有 Wordnik API 的密钥，他们使用这些密钥构建从教育科技应用程序到文字游戏到 Twitter 机器人的所有内容！我们的原始架构自 2010 年以来已处理了超过 20 亿次调用，并且在很大程度上一直是一项免费服务。当 Wordnik 于 2014 年底作为非营利组织重新启动时，我们意识到我们需要将我们的 API 货币化以创建可持续发展的未来发展基础，并且为了货币化，我们需要降低运营成本并引入新功能——我们之前的架构都没有简化这些。进入 AWS Lambda+API Gateway！通过将我们当前的 API 分解成微小的函数，我们可以利用当前的微服务热潮，而无需担心操作方面的麻烦。通过使用 Elastic Beanstalk 和 3Scale 来管理反向代理，处理旧 API 调用和新 API 调用之间的路由以及管理计费也变得容易得多。在顶部添加一个漂亮的 Swagger 接口，您就可以开始了……更快、更便宜！

---

11 月 4 日

测试和监控
使用 Cucumber 测试您的 API | 上午 11:15 – 下午 12:45
Ole Lensmar，SmartBear 软件首席技术官
使用 Cucumber 进行的 BDD 越来越受欢迎，因为它允许使用自定义领域特定语言表达需求，这些需求可以作为测试执行以验证实际的实现。API 特别似乎可以通过这种方法获得很多好处，因为它们通常具有技术性；似乎正确执行的 Cucumber 实现应该允许越来越多的非技术利益相关者参与定义 API 行为和功能的需求。但是，Cucumber 词汇表可以变得多么“非技术性”以描述像 API 这样本质上是技术性的东西？何时使用命令式方法与声明式方法是有意义的？如何将简单的语言转换为复杂的有效负载和验证？随着 API 复杂性的增加，Cucumber 的使用如何扩展？以及像 Swagger 这样的标准如何使 Cucumber 测试更加直观？我知道您非常想知道——所以不要错过这个采用 API 黄瓜涅槃之路的机会！

金融科技
OpenAPI 超越 API 文档 | 下午 2:00 – 下午 3:30
Arnaud Lauret，AXA Banque IT 架构师
OpenAPI 提供了许多可能性，涵盖整个 API 生命周期，但它仅被视为生成 API 文档的解决方案。本课程将讲述 AXA Banque 从 .doc 和 .pdf API 文档到广泛使用 OpenAPI 规范（以前称为 Swagger）的演变历程。在整个过程中，我们将确定 API 定义语言除了简单地生成 API 文档之外的许多优势，包括设计、测试、文档持续交付、代码生成、模拟和原型设计新想法。

站在巨人的肩膀上：Capital One 如何构建其 API | 下午 2:00 – 下午 3:30
Abdelmonaim Remani，Capital One DevExchange 工程技术负责人

自REST架构风格首次引入以来，一直存在着高度模糊性和大量歧义的问题。早期缺乏具体的参考实现，导致最受欢迎的Web API成为了事实上的标准。为了赢得每一位Web开发者的青睐，领先的技术公司投入巨资构建RESTful API，并投入大量资源推广他们自己的REST版本。Capital One也不例外。尽管对于一家如此规模的金融机构来说，这似乎违反直觉，并且在一个受限于过时技术和监管约束的行业中扮演角色极具挑战，但Capital One正在全面开展一项公司范围内的举措，通过使用最新和最棒的开源技术实现的内部和面向公众的API来公开金融服务。本次演讲将介绍Capital One如何使用REST，其中涉及的风险和赌注远高于为客户提供错误的转向指示。

API的全生命周期工具支持 | 下午2:00 – 3:30
Steven Fonseca，首席服务架构师，Intuit
演讲的重点是展示Intuit内部的一个名为API生命周期管理器的工具，这是一个Web应用程序和一组API，使IT组织能够在其整个生命周期中（从构思到退休）高效地生成API。与会者将了解Intuit IT如何协调构建战略性API组合，包括其功能分配和服务所有权、具有当前行业建模语言中找不到的创新功能的全面合同文档、文档生成和交付。API生命周期管理器的示例将在一个故事的背景下展示，说明IT如何帮助Intuit产品提供愉悦的客户体验，特别是在基于订阅的计费和电子商务领域。