在 Swagger returns 结构错误中使用逗号分隔的字符串查询参数

Question

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

should NOT have additional properties additionalProperty: style, explode

我在 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（这是默认选项，可以省略）。