Swagger 2.0 Anyof

Question

什麼是Swagger 2.0版本中的任何版本，請告訴我如何更新我的json文件，因爲我想將我的文檔從swagger 1.0升級到2.0。

感謝您的幫助。

Answer 1

我不認爲有一個，它感覺像一個很大的缺點。這絕對沒有在the Schema Object portion of the specification中提及。他們召喚出元素那裏，已經從JSON模式和anyOf採用的是不在其中：

以下屬性是直接從JSON模式定義拍攝並遵循相同的規格：

• $ REF - 作爲一個JSON參考
• 格式（見數據類型格式的其他細節）
• 標題
• 描述（GFM語法可用於富文本representat離子）
• 默認（不像JSON架構，該值必須符合的架構對象的定義的類型）
• multipleOf
• 最大
• exclusiveMaximum
• 最小
• exclusiveMinimum
• 最大長度
• minLength
• pattern
• maxItems
• minItems
• uniqueItems
• maxProperties
• minProperties
• 需要
• 枚舉
• 類型

以下屬性從JSON架構定義但它們的定義取調整到Swagger規格。它們的定義與JSON模式中的定義相同，只是在原始定義引用JSON模式定義的情況下，纔會使用模式對象定義。

• 項目
• allOf
• 性能
• additionalProperties

我認爲最接近的就是discriminator場，但是這意味着你必須構建你的輸出，以適應昂首闊步。

Answer 2

anyOf和oneOf現在支持OpenAPI Specification 3.0（2017年7月26日發佈）。