如何在swagger中描述Data Type Array[]的参数

Question

如何在swagger UI中将数组对象传递给参数？这是一个GET请求。我有一个数据类型为Array[]和参数类型为query的请求参数。我已经尝试了下面的阵列，它似乎不工作。我不熟悉招摇的用法。无法解决问题。

["dataType": 1,"value": "test","orderid": 1]
[1,1 , 1, 1]
[{1,1 , 1, 1}]
[{"dataType": 1,"value": "test","orderid": 1}]
[ dataType: 1]

型：

public class ItemModel
{
    public int DataType { get; set; }
    public string Value { get; set; }
    public int OrderId { get; set; }
}

Answer 1

这里您要做的是在< code>components部分(< code>schema子部分)中包含对象定义，然后使用< code>$ref关键字链接到< code>items:下的模式。

这是我使用您描述的参数制定的快速示例：

示例:

架构：

components:
  schemas:
    itemModel:
      properties:
        dataType:
          type: integer
        value:
          type: string
        orderType:
          type: integer
    requestParam:
      properties:
        orders:
          type: array
          items:
            $ref: '#/components/schemas/requestParam'

定义:

    paths:
  /pets:
    post:
      summary: Add a new pet

      requestBody:
        description: Optional description in *Markdown*
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/requestParam'

另一个例子（项目符号 3）http://blog.restcase.com/6-most-significant-changes-in-oas-3-0/