如何在Swagger中解析对象数组

Question

我试图在大摇大摆地描述以下post参数：

“任何人”=[“971”，50.0，70.0]，“832”，50.0，30.0]，“134A”，50.0，100.0]]

Answer 1

您的嵌套数组可以被视为元组数组。元组是使用prefix Items定义的。元组数组定义如下：

# openapi: 3.1.0

type: array
items:
  type: array
  prefixItems:
    # The 1st item
    - type: string
      description: Description of the 1st item
      example: "971"
    # The 2nd item
    - type: number
      description: Description of the 2nd item
      example: 50.0
    # The 2nd item
    - type: number
      description: Description of the 3nd item
      example: 70.0

  # The total number of items in this tuple
  minItems: 3
  maxItems: 3
  additionalItems: false   # can be omitted if `maxItems` is specified

内部数组可以定义为通用混合类型数组，即“可以包含字符串和数字”。但您不能具体定义第一个元素是字符串，其余的是数字。这给了我们：

type: array
items:
  type: array
  items:
    oneOf:
      - type: string
      - type: number
  example: ["971", 50.0, 70.0]

这个版本实际上不支持混合类型数组，比如[“971”，50.0，70.0]。您最多只能对内部数组的项使用无类型模式{}，这意味着内部数组可以包含除nulls之外的任何值。您无法指定项的确切类型，但可以添加具有不同项类型的数组的示例。

# swagger: '2.0'

type: array
items:
  type: array
  items: {}
  example: ["971", 50.0, 70.0]

Answer 2

我想这是正确答案

    ِAnyOne:
      type: array
      items:
        type: object
        properties:
          one:
            type: string
            description: description
         hello1:
            type: number
            description: description
            format: double
          hello2:
            type: number
            description: description