swagger返回枚举_Swagger:从枚举中取一个或多个值

包含以逗号分隔的值列表的查询参数定义为数组。如果值是预定义的,则它是枚举数组。

默认情况下,数组可能包含任意数量的项目,这些项目符合“无或更多”要求。如果需要,您可以使用minLength和maxLength限制项目数量,并可以选择强制执行uniqueItems: true。

OpenAPI 2.0

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

parameters:

- name: sort

in: query

type: array #

items:

type: string

enum: [field1, field2, field3]

collectionFormat: csv #

required: false

description: Sort the results by attributes. (See http://jsonapi.org/format/1.1/#fetching-sorting)

OpenAPI 3.0

来自OpenAPI 2.0的

collectionFormat: csv已替换为style: form + explode: false。 style: form是查询参数的默认样式,因此可以省略。

parameters:

- name: sort

in: query

schema:

type: array #

items:

type: string

enum: [field1, field2, field3]

required: false

description: Sort the results by attributes. (See http://jsonapi.org/format/1.1/#fetching-sorting)

explode: false #

我认为不需要allowEmptyValue,因为在这种情况下,空数组实际上是空值。此外,allowEmptyValue是not recommended,因为它将在未来版本中删除,因此将在OpenAPI 3.0.2中使用。“

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值