Open api 3.0如何支持具有多个值的单个查询参数键?

时间:2020-06-23 04:17:33

标签: swagger openapi

对于具有以下格式的api:GET /resource?param=value1&param=value2&param=value3 在开放的Api 2.0中,我们可以这样指定:

parameters:
    - in: query
      name: color
      type: array
      collectionFormat: multi
      items:
        type: string 

但是在v3.0中,属性collectionFormat不可用。因此,在尝试使用collectionFormat时,我收到错误消息should not have additional property: collectionFormat

我已经搜索了文档,但找不到任何答案。有谁知道从2.0到3.0版本的新实现应该是什么?

1 个答案:

答案 0 :(得分:2)

您可以使用类似这样的内容...

  - name: param
    in: query
    description: Id description
    required: false
    style: form
    explode: true
    schema:
      type: array
      items:
        type: string

其中爆炸:true将形成param = abc&param = xyz等 并爆炸:false将形成param = abc,xyz