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
暂无签名
中国开发者画像洞察报告 2022
本次报告为你深度解读开发者人群背景，分析开发者群体面临的挑战，洞察开发者人群特征，预测开发者生态发展...
评论