如何在swagger属性中添加多个示例值？

Question

我正在使用Swagger OpenAPI规范工具，我在其中一个定义中有一个字符串数组属性，如下所示:

cities:
        type: array
        items:
          type: string
          example: "Pune"

我的API生成JSON结果，因此对于上述对象，以下结果出现在响应中:

{
  "cities": [
    "Pune"
  ]
}

尝试逗号分隔字符串，如下所示：

cities:
            type: array
            items:
              type: string
              example: "Pune", "Mumbai", "Bangaluru"

预期结果为:

{
      "cities": [
        "Pune",
        "Mumbai",
        "Bangaluru"
      ]
    }

但是编辑器显示错误。"缩进错误"

我想给示例标签赋予多个值，有什么办法吗？

更新

下面的用户Helen给出了正确答案，我有缩进问题，因此有嵌套数组(2d数组)

正确方式：

cities:
        type: array
        items:
          type: string
        example: 
        - Pune
        - Mumbai

我的方式（这是错误的）

cities:
        type: array
        items:
          type: string
          example: 
          - Pune
          - Mumbai

在上面两种情况中寻找< code>example标记的缩进，它的YAML缩进很重要。

Answer 1

对于开放API版本 - 3.0.0

  major:
      type: array
      items:
        type: string
        enum:
          - Accounting
          - Business Contacts
          - Economy
          - Finance
          - Graphic Design
          - International Business Administration
          - International Relations
          - Law
          - Marketing
          - others
          - Political Science
          - Statistics

Answer 2

要显示包含多个项的数组示例，请在数组级别而不是项目级别添加该示例：

cities:
  type: array
  items:
    type: string
  example:
    - Pune
    - Mumbai
    - Bangaluru

  # or
  # example: [Pune, Mumbai, Bangaluru]

对于对象数组，该示例如下所示：

type: array
items:
  type: object
  properties:
    id:
      type: integer
    name:
      type: string
example:
  - id: 1
    name: Prashant
  - id: 2
    name: Helen