Swagger 2.0 Yaml中的多个请求示例

Swagger 2.0 Yaml中的多个请求示例,swagger,openapi,swagger-2.0,Swagger,Openapi,Swagger 2.0,我有一个API,其中包含一些json有效负载的互斥参数。我想在多个示例中显示这一点,但yaml文件中的模式似乎只能生成一个示例 如果我的意见是: { “文本”:“一些文本” } 或 { “列表”:[“一些文本”,“更多”] } 但不是 { “文本”:“一些文本”, “列表”:[“一些文本”,“更多”] } 如何在swagger 2.0中实现这一点 下面这样的模式定义是误导性的 定义: 互斥模式: 类型:对象 特性: 名单: 类型:数组 项目: 类型:字符串 示例:[“一些文本”,“更多”]

我有一个API,其中包含一些json有效负载的互斥参数。我想在多个示例中显示这一点,但yaml文件中的
模式似乎只能生成一个示例

如果我的意见是:

{
“文本”:“一些文本”
}

{
“列表”:[“一些文本”,“更多”]
}
但不是

{
“文本”:“一些文本”,
“列表”:[“一些文本”,“更多”]
}
如何在swagger 2.0中实现这一点

下面这样的模式定义是误导性的

定义:
互斥模式:
类型:对象
特性:
名单:
类型:数组
项目:
类型:字符串
示例:[“一些文本”,“更多”]
正文:
类型:字符串
示例:“一些文本”

而且您似乎无法指定多个
body
选项。显示互斥有效负载及其相应响应的好方法是什么?

OpenAPI 2.0不支持互斥属性,但您可以通过向模式中添加
minProperties:1
maxProperties:1
来模拟这一点。这本质上意味着只能传递
文本
或只能传递
列表
,但不能同时传递两者

定义:
互斥模式:
类型:对象
特性:
名单:
类型:数组
项目:
类型:字符串
示例:[“一些文本”,“更多”]
正文:
类型:字符串
示例:“一些文本”
物业:1#