Fatal编程技术网
  • swagger/
  • Swagger 招摇过市：从枚举中获取一个或多个值

Swagger 招摇过市：从枚举中获取一个或多个值

swagger

Swagger 招摇过市：从枚举中获取一个或多个值,swagger,swagger-2.0,openapi,Swagger,Swagger 2.0,Openapi,我正在编写一个OpenAPI（Swagger）定义，其中查询参数可以不取任何值，也可以取N个值，如下所示： /path?sort=field1,field2 如何在OpenAPI YAML中编写 我尝试了以下方法，但没有产生预期的结果： -名称：排序 in:查询 模式： 类型：字符串 枚举：[字段1、字段2、字段3] allowEmptyValue:true 必填项：false 描述：按属性对结果排序。（见http://jsonapi.org/format/1.1/#fetching-（分类）

我正在编写一个OpenAPI（Swagger）定义，其中查询参数可以不取任何值，也可以取N个值，如下所示：

/path?sort=field1,field2
如何在OpenAPI YAML中编写

我尝试了以下方法，但没有产生预期的结果：

-名称：排序
in:查询
模式：
类型：字符串
枚举：[字段1、字段2、字段3]
allowEmptyValue:true
必填项：false
描述：按属性对结果排序。（见http://jsonapi.org/format/1.1/#fetching-（分类）
包含逗号分隔的值列表的查询参数定义为数组。如果值是预定义的，则它是enum的数组

默认情况下，一个数组可以有任意数量的项，这些项符合您的“无或多”要求。如果需要，您可以使用
minItems
和
maxItems
限制项目数量，并可以选择强制执行
uniqueItems:true

OpenAPI 2.0 参数定义如下所示
collectionFormat:csv
表示值以逗号分隔，但这是默认格式，因此可以省略

参数：
-名称：排序
in:查询

类型：数组#那么它是“一个或多个值”（例如，如果存在，必须至少有一个值）还是“无或n个值”（例如，可能不存在值，如在
？排序
）？它是“无或多个”。这就是为什么存在
allowEmptyValue:true
<代码>？sort=
，
？sort=field1
，
？sort=field1，field2
是有效路径。谢谢，我将尝试一下。谢谢你的回答。不幸的是，这对我来说很不公平：\@Helen:swagger支持带有键值对的枚举吗？