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

Question

我试图在 Swagger 中定义一个查询参数，其中包含来自预定义项目集的逗号分隔字符串，?fruits=Apples,Oranges,Bananas但我从 swagger 编辑器中收到以下错误

不应该有额外的属性 additionalProperty: 样式，爆炸

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