Swagger Codegen反向兼容性

Question

我已经开始使用Swagger。此时，我收到了一个swagger版本1.2的swagger文件。但是，如果我想用这个文件生成一些东西，它只会给我一堆看起来更像它的错误，只是忽略了我的swagger文件在1.2版规范中的事实，只是继续并根据规范的2.0版验证它。

我得到的一些错误：

• 缺少所需属性：路径
• 不允许附加属性：模型、apis、resourcePath、swaggerVersion、apiVersion
• ...

最后一个错误告诉我apiVersion未知，尽管gitHub页面声称最新的稳定版应该兼容1.0、1.1、1.2和2.0版本。有没有一种方法可以让我“强迫”生成器考虑1.2规范而不是2.0规范？

我也用官方的1.2规范yaml文件进行了验证：https://raw.githubusercontent.com/swagger-api/swagger-codegen/v2.0.18/samples/yaml/pet.yml

但在Swagger编辑器中加载时，会出现相同的错误：http://editor.swagger.io/#/

Answer 1

swagger-codesen项目依赖于swagger-parser，它有一个名为swagger-compat-spec-parser的模块，它实际上会将您的1.2规范转换为2.0格式在传递给代码生成器之前。

您看到的错误是因为该转换失败。您可以在本地保存swagger 1.2文件，调整它们，然后重新运行处理。

从1.2到2.0的转换面临的挑战是，swagger 1.2最初没有一个模式来验证。因此，有很多无效的虚张声势，而且从技术上来说，将1.2规范中的所有不同问题转换到2.0中是不可能的。

也就是说，我们一直在努力改进工具，因此如果您在1.2转换器中发现“可重复”的错误，请在＜code＞swagger spec＜/code＞项目中提交一个问题，我们将看到如何修复它（大多数都很容易）。