swagger - open api 3.0 如何支持具有多个值的单个查询参数键？

Question

对于具有这种格式的 api:GET/resource?param=value1&param=value2&param=value3在open 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 版本的新实现应该是什么？

Answer 1

你可以使用这样的东西......

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

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