Swagger - 如何定义多维数组

Question

我找不到任何这方面的例子。也许是因为缺乏我的Swagger知识或者可能没有类似的例子。

是否可以编写一个swagger定义，其中公开的类型是多维数组？

Answer 1

由于swagger使用Json Schema来模拟API上公开的类型，因此您真的需要知道如何在Json Schema中建模多维（Nd）数组。

答案是：Json Schema中没有内置的Nd数组支持。

但是，json架构确实支持arrays，并且没有什么能阻止数组中的项自身成为数组。因此，您只需使用数组数组即可定义Nd数组。

"2dArrayOfInt": {
  "type": "array",
  "items": {
    "type": "array",
    "items": {
      "type": "integer" // This will be a 2d array of numbers
      ...
    }
  }
}

不好，但Nd数组也不行。