OpenAPI Initiative (OAI) 致力于创建、发展和推广基于 Swagger 规范的供应商中立的 API 描述格式。作为 Linux 基金会下的一个开源项目,OAI 致力于开发和推广 OpenAPI 规范供所有人使用。我们欢迎来自成员和非成员的贡献。
您和您的组织可以做很多事情来帮助社区。
- 利用规范:使用 OpenAPI 规范无需支付任何费用或会员资格要求:GitHub | OpenAPI 规范
- 开发规范:欢迎社区所有成员参与关于如何发展规范的讨论。找到一个适用于您项目的元问题。如果您没有看到此处的任何问题,请记录一个新的问题。
- 分享您如何使用规范。
- 如果您希望直接支持该项目,请考虑让您的公司加入 OAI 成为成员。填写此表单以了解更多信息。项目章程在此。
不确定如何开始?阅读如何参与此处。
11月3日
API 设计与治理 | 上午 11:00 – 下午 12:30
Matthew Reinbold,Capital One DevExchange API 卓越中心负责人
当一家公司决定将所有内容都变成 API 时会发生什么?组织可能会快速效仿 Netflix 和 Amazon,追求微服务和面向服务的架构 (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 响应的过程。我们将讨论外观过程的哪些部分可以自动化,哪些部分需要设计决策。最后,我们将探讨使用这种新的 API 风格可以获得哪些功能以及会失去哪些功能,以便您可以对 SOAP 服务的未来做出明智的决策。
大图景中的大问题 | 下午 3:05 – 下午 4:35
Amber Fallon,SmartBear 软件
API 非常庞大。比我们许多人,甚至包括我们行业中的一些人所意识到的还要庞大——事实上,公开 API 的总数已从 2012 年的不到 7500 个激增到 2015 年的超过 15000 个。大型公司拥有更大的 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 创始人
超过 18000 名开发人员拥有 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
史蒂文·丰塞卡,首席服务架构师,Intuit
本次演讲的重点是展示Intuit内部的一个名为API生命周期管理器的工具,这是一个Web应用程序和一组API,使IT组织能够在其生命周期的各个阶段(从构思到淘汰)高效地生成API。听众将了解Intuit IT如何协调战略性API组合的构建,包括其功能分配和服务所有权、包含当前行业建模语言中找不到的创新的全面合同文档、文档生成和交付。API生命周期管理器的示例将以IT如何帮助Intuit产品交付愉悦的客户体验的故事为背景进行展示,尤其是在基于订阅的计费和商业领域。