OpenAPI规范3.0版接近最终发布

OpenAPI

摘要： “开放API战略”(Open API Initiativev) 发布了OpenAPI规范3.0版的预览，其中给出了一些重大改进。

作者： Abel Avram

正文：

“开放API战略”(Open API Initiativev) 发布了OpenAPI规范3.0版的预览，并规划于今年二月底发布实施草案（Implementer Draft）。

新的OpenAPI规范3.0带来了如下重大改进：

• 为实现更好的可重用性，对规范的整体架构进行了重构，重构后的架构如下图所示。
• 支持oneOf、anyOf和not的JSON模式。
• 可使用模式的参数。
• 引入了Cookie参数，去除了dataForm参数。
• 具有自身实体的主体参数（Body Parameter）。
• 可协商的内容类型。
• 多主机支持。
• 简化了安全定义，改进的WebHooks不再通过回调机制描述。

“开放API战略”作为负责规范开发的组织，计划在今年二月底前给出首个实施草案。

已公布的OpenAPI规范目标是：

定义标准的、独立于语言的指向REST API的接口，使得服务能力无需访问源代码、文档，或是借助于网络流量检查，就可被人类和计算机发现并理解。通过对OpenAPI做适当定义后，消费者可使用最小数量的实现逻辑理解远程服务，并与远程服务交互。

OpenAPI基于Swagger 2.0构建，Swagger是SmartBear贡献给Linux基金会的。意在构建具有中立管理模型的新组织，以引领Swagger更上一层楼。“开放API战略”的创始成员包括对贡献具有兴趣的Google、IBM和Microsoft。同时还成立了一个技术开发者社区（TDC，Technical Developer Community）以对规范做开发。TDC对于任何有意向做出贡献的个人都是开放的，无需会员身份。

在对“上百个任务单和上千条评论”近一年的处理工作后，现在OpenAPI规范已接近于最终发布，不会再有任何其他重大改进。

查看英文原文：The OpenAPI Spec Reaches 3.0