Open API Initiative发布OpenAPI规范3.0.0

API

摘要：

Open API Initiative发布了OpenAPI规范（OAS）3.0.0版本。

正文：

Open API Initiative发布了OpenAPI规范（OAS）3.0.0版本。

历经将近两年的开发和7个月的发布流程，从2017年1月开始发表声明，到2月份发布实现草案，再到6月份公开讨论，这一版本才得以诞生。InfoQ之前报导过OAS 3.0的关键新特性，包括支持回调、多主机、改进的JSON Schema，以及添加新的内容，如Components和Links。

社区反响热烈，Twitter上满是表达祝贺和激动心情的推文，开源和商用工具也开始大力支持OAS 3.0。3.0版本既是OAS规范的一个里程碑版本，也是Open API Initiative（OAI）的版本，OAI目前受Linux基金会监管。

OAS技术开发者社区（TDC）的Ron Ratovsky向InfoQ讲述了有关3.0版本的发展路径以及他们在发布新版本时所面临的挑战。OAS托管在GitHub上三年多了，从2014年9月开始，6个TDC成员解决并关闭了580多个问题，还有200多个尚未解决。在谈及请求的管理、讨论和优先级安排时，Ratovsky强调，在推进OAS目标时要注重广大用户的需求，即标准化和改进对REST API的描述。在这方面，他们已经在讨论支持新的协议和新的模式（如GraphQL），不过讨论的内容尚未被加入到路线图中。

OAS 3.0中包含的Links对象被称为超媒体的“nod”，是为了解决社区中广泛存在的一个问题而被加入规范的。Links对象是超媒体之外的另一个选择，它是静态的，而超媒体是动态且自文档（self-documenting）的，Ratovsky说，“我们想着该如何提供一个方案，最后我们把它定义为静态的。我们希望得到更多有关Links这一特性的反馈。我们希望能够扩展这一特性，并为超媒体带来更多的可能性。”

除了Links对象，TDC成员希望能够得到更多其他方面的反馈。与其他开源项目一样，OAS也依赖社区的支持和参与。“我们依赖社区的努力——特性请求、发表意见、拉取请求”，Ratovsky说，“我希望能够收到更多来自产品经理、QA工程师、技术作者和API生命周期相关人员的反馈。我们想知道OAS要怎样才能让他们的工作变得更美好。”

用户可以在OAS的GitHub仓库里找到如何参与项目的相关信息。SmartBear将在8月9号举办一个webinar，对实现新特性感兴趣或正在从Swagger 2.0迁移到OAS 3.0的人可以关注下。

查看英文原文：The Open API Initiative Announces the OpenAPI Specification 3.0.0