在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]
  ]
}

的数据属性必须是一个多维阵列中,且理想地它可以包含任意数量的"行",每个具有任意数量的包含在每个字段中的任何类型的数据的列组成.我甚至满足于模式允许数据只是一个任何东西的数组,但我无法弄清楚如何让它工作.

Answer 1

所有你需要做的是改变type了的items架构中array.以下模式表示"data"是一个数组,其项目是数组.内部数组没有约束.

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