OpenAPI规范3.0版接近最终发布

jopen 7年前
   <p style="text-align: center;"><a href="/misc/goto?guid=4958190462259388048" title="程序员"><img alt="OpenAPI规范3.0版接近最终发布" src="https://simg.open-open.com/show/a08e318ff2ebc4ad30d5e6ff0cd93701.jpg" /></a></p>    <p>英文原文:<a href="/misc/goto?guid=4958998833778985903">The OpenAPI Spec Reaches 3.0</a></p>    <p><a href="/misc/goto?guid=4958998833872189028">“开放 API 战略”</a>(Open API Initiativev) 发布了 OpenAPI 规范 3.0 版的预览,并规划于今年二月底发布实施草案(Implementer Draft)。</p>    <p>新的 <a href="/misc/goto?guid=4958998833971826458">OpenAPI 规范 3.0</a>带来了<a href="/misc/goto?guid=4958998834064397400">如下重大改进</a>:</p>    <ul>     <li>为实现更好的可重用性,对规范的整体架构进行了重构,重构后的架构如下图所示。</li>     <li>支持 oneOf、anyOf 和 not 的 JSON 模式。</li>     <li>可使用模式的参数。</li>     <li>引入了 Cookie 参数,去除了 dataForm 参数。</li>     <li>具有自身实体的主体参数(Body Parameter)。</li>     <li>可协商的内容类型。</li>     <li>多主机支持。</li>     <li>简化了安全定义,改进的 WebHooks 不再通过回调机制描述。</li>    </ul>    <p style="text-align:center"><img alt="OpenAPI规范3.0版接近最终发布" src="https://simg.open-open.com/show/a2f8eb99959310d984cae0cb3eb19f9b.png" /></p>    <p><a href="/misc/goto?guid=4958998833872189028">“开放 API 战略”</a>作为负责规范开发的组织,计划在今年二月底前给出首个带来了。</p>    <p>已公布的 OpenAPI 规范目标是:</p>    <blockquote>     <p>定义标准的、独立于语言的指向 REST API 的接口,使得服务能力无需访问源代码、文档,或是借助于网络流量检查,就可被人类和计算机发现并理解。通过对 OpenAPI 做适当定义后,消费者可使用最小数量的实现逻辑理解远程服务,并与远程服务交互。</p>    </blockquote>    <p>OpenAPI 基于 Swagger 2.0 构建,Swagger 是 SmartBear 贡献给 Linux 基金会的。意在构建具有中立管理模型的新组织,以引领 Swagger 更上一层楼。“开放 API 战略”的创始成员包括对贡献具有兴趣的 Google、IBM 和 Microsoft。同时还成立了一个技术开发者社区(TDC,Technical Developer Community)以对规范做开发。TDC 对于任何有意向做出贡献的个人都是开放的,无需会员身份。</p>    <p>在对“上百个任务单和上千条评论”近一年的处理工作后,现在 OpenAPI 规范已接近于最终发布,不会再有任何其他重大改进。</p>    <p>来自: <a href="/misc/goto?guid=4958998834161896701" id="link_source2">InfoQ</a></p>