Swagger 2.0 Anyof

Question

在Swagger版本2.0中，什么等同于任何一个，请告诉我如何更新我的json文件，因为我想将我的文档从swagger 1.0升级到2.0。

谢谢你的帮助。

Answer 1

OpenAPI规范3.0(2017年7月26日发布)现已支持< code>anyOf和< code>oneOf。

Answer 2

我不认为有一个，这感觉像是一个大缺点。规范的模式对象部分中肯定没有提到它。它们调用了JSON模式中采用的元素，anyOf不在其中：

以下属性直接取自JSON模式定义，并遵循相同的规范:

• $ref - 作为 JSON 参考
• 格式（有关更多详细信息，请参阅数据类型格式）
• 标题
• 说明（GFM 语法可用于富文本表示）
• 默认值（与 JSON 架构不同，值必须符合架构对象的已定义类型）
• 多个的
• 最大
• 独占最大值
• 最低
• 独家最小值
• 最大长度
• 最小长度
• 模式
• 最大项
• 最小项目
• 唯一项目
• 最大属性
• 最小属性
• 必填
• 枚举
• 类型

以下属性取自JSON Schema定义，但它们的定义已调整为Swagger规范。它们的定义与JSON Schema中的定义相同，只是在原始定义引用JSON Schema定义的情况下，才使用Schema Object定义。

< li >项目 < li >全部 < li >属性 < li >附加属性

我认为最接近的是鉴别器字段，但这意味着您必须构建输出以适应Swagger。