各位开发人员好，

这篇文章旨在阐明OpenAPI规范2.0和3.0之间的主要区别。了解主要的不兼容差异将有助于从2.0规范迁移到3.0规范

1。版本如何知道api定义是遵循2.0规范还是3.0规范？在2.0规范中有一个名为"swagger"的属性，它告诉您规范的版本，例如

3.0这将被新属性"openapi"替换，应按以下方式使用，

2。多个服务器Open API spec 2.0只为一个主机或一个服务器的详细信息提供占位符，大数据系统，不支持有多个服务器信息。这一缺点在3.0规范中得到了解决，大数据培训班，因此现在有了新的servers对象数组，在该数组中，您还可以使用主机url中的任何变量占位符获得主机信息。示例：

在上述示例中，url将用户名、端口和基本路径作为变量字段（占位符），淘客返利系统，这些字段在变量对象部分中进行了描述，并且可以为每个字段提供默认值。在swagger ui中呈现此多服务器详细信息如下，

3。组件openapispec3.0提供了components对象，它可以包含模式、参数、响应、示例、安全方案、链接、请求体、头和回调。此组件对象在API中的某个位置被引用之前不会影响API。优点：如果一个API的多个操作需要相似的输入结构，那么可以在组件下将输入结构定义为请求体，并可以在多个路径中重用。同样，头、响应等也可以重用。安全定义2.0

3.0

对定义中的所有资源在操作上或全局上应用安全性保持不变。

请评论如果有任何澄清或问题，我将尝试以正确的答案返回。非常感谢。

，云零售，永久免费自助建站软件