在 Swagger 中，如何将参数定义为多维数组？

Question

在 Swagger 中，我可以创建一个像这样的任何类型的数组的参数：

"MyType" : {
  "description" : "my example object type",
  "type" : "object",
  "properties" : {
    "id" : {
      "description" : "identifier",
      "type" : "number"
    },
    "data" : {
      "description" : "data container",
      "type" : "array",
      "items" : {
        "type" : "string"
      }
    }
  }
}

其中定义了一个可能如下所示的对象：

{
  "id" : 1,
  "data" : ["a", "b", "c"]
}

但我需要做的是定义一个可能看起来像这样的对象：

{
  "id" : 1,
  "data" : [
    [0, 1, 2],
    ["a", "b"],
    [true, "foo", 99, false]
  ]
}

data 属性需要是一个多维数组，理想情况下它可以包含任意数量的“行”，每行包含任意数量的列，每个字段中包含任何类型的数据。我什至会满足于允许 data 只是一个数组的架构，但我不知道如何让它工作。

Answer 1

您只需将items 架构的type 更改为array。以下模式表示“数据”是一个数组，其项目是数组。内部数组没有约束。

"data" : {
  "description" : "data container",
  "type" : "array",
  "items" : {
    "type" : "array",
    "items": {}
  }
}