Swagger 2.0 Yaml中的多个请求示例
我有一个API,其中包含一些json有效负载的互斥参数。我想在多个示例中显示这一点,但yaml文件中的Swagger 2.0 Yaml中的多个请求示例,swagger,openapi,swagger-2.0,Swagger,Openapi,Swagger 2.0,我有一个API,其中包含一些json有效负载的互斥参数。我想在多个示例中显示这一点,但yaml文件中的模式似乎只能生成一个示例 如果我的意见是: { “文本”:“一些文本” } 或 { “列表”:[“一些文本”,“更多”] } 但不是 { “文本”:“一些文本”, “列表”:[“一些文本”,“更多”] } 如何在swagger 2.0中实现这一点 下面这样的模式定义是误导性的 定义: 互斥模式: 类型:对象 特性: 名单: 类型:数组 项目: 类型:字符串 示例:[“一些文本”,“更多”]
模式似乎只能生成一个示例
如果我的意见是:
{
“文本”:“一些文本”
}
或
{
“列表”:[“一些文本”,“更多”]
}
但不是
{
“文本”:“一些文本”,
“列表”:[“一些文本”,“更多”]
}
如何在swagger 2.0中实现这一点
下面这样的模式定义是误导性的
定义:
互斥模式:
类型:对象
特性:
名单:
类型:数组
项目:
类型:字符串
示例:[“一些文本”,“更多”]
正文:
类型:字符串
示例:“一些文本”
而且您似乎无法指定多个body
选项。显示互斥有效负载及其相应响应的好方法是什么?OpenAPI 2.0不支持互斥属性,但您可以通过向模式中添加minProperties:1
和maxProperties:1
来模拟这一点。这本质上意味着只能传递文本
或只能传递列表
,但不能同时传递两者
定义:
互斥模式:
类型:对象
特性:
名单:
类型:数组
项目:
类型:字符串
示例:[“一些文本”,“更多”]
正文:
类型:字符串
示例:“一些文本”
物业:1#