Swagger 中以逗号分隔的字符串的查询参数返回结构错误

Question

我正在尝试在 Swagger 中使用逗号分隔的字符串从预定义的一组项目中定义一个查询参数，例如 ?fruits=Apples,Oranges,Bananas，但我从 swagger 编辑器中收到以下错误

不应该有额外的属性 additionalProperty: style, 爆炸

我在 Swagger 编辑器中尝试的是：

    - in: query
      name: fruits
      style: form
      explode: true
      required: false
      description: Filter by fruits
      type: array
      items:
        type: string
        enum:
          - Apples
          - Oranges
          - Bananas

Answer 1

style 和 explode 是 OpenAPI 3.0 关键字。但是您似乎正在使用 OpenAPI 2.0，它使用 collectionFormat 代替。在这种情况下，您需要collectionFormat: csv（这是默认选项，可以省略）。