Arrays 没有名字的字符串数组

Arrays 没有名字的字符串数组,arrays,api,documentation,swagger,swagger-ui,Arrays,Api,Documentation,Swagger,Swagger Ui,目前我正在尝试为我的软件创建一个招摇过市的文件。 现在我想为时间范围创建一个定义。 我的问题是,此阵列看起来如下所示: timeRange: { "2016-01-15T09:00:00.000Z", // this is the start date "2017-01-15T09:00:00.000Z" // this is the end date } "timeRange": [ "2017-01-15T09:00:00.000Z,2017-01-15T09:00:00.00

目前我正在尝试为我的软件创建一个招摇过市的文件。 现在我想为时间范围创建一个定义。 我的问题是,此阵列看起来如下所示:

timeRange: {
  "2016-01-15T09:00:00.000Z", // this is the start date
  "2017-01-15T09:00:00.000Z" // this is the end date
}
"timeRange": [
  "2017-01-15T09:00:00.000Z,2017-01-15T09:00:00.000Z"
]
如何创建开箱即用的示例值? 它是一个“字符串数组”,最少有两个字符串

"timeRange": {
  "type": "array",
  "items": {
    "type": "string",
    "example": "2017-01-15T09:00:00.000Z,2017-01-15T09:00:00.000Z"
  }
}
这将生成如下示例:

timeRange: {
  "2016-01-15T09:00:00.000Z", // this is the start date
  "2017-01-15T09:00:00.000Z" // this is the end date
}
"timeRange": [
  "2017-01-15T09:00:00.000Z,2017-01-15T09:00:00.000Z"
]
此示例不起作用,因为它是数组而不是对象。 总而言之: 如何实现由两个不同字符串(没有名称)组成的示例值

希望你能帮助我! 干杯

无效的JSON–“时间范围”需要用引号括起来,并且对象/数组语法应该不同

如果使用对象语法
{}
,则需要将值命名为属性:

"timeRange": {
  "start_date": "2016-01-15T09:00:00.000Z",
  "end_date": "2017-01-15T09:00:00.000Z"
}
否则,
timeRange
需要是一个
[]
数组:

"timeRange": [
  "2016-01-15T09:00:00.000Z",
  "2017-01-15T09:00:00.000Z"
]

在第一个示例(
{}
对象)中,您的招摇过市看起来如下所示,每个命名属性都有一个单独的
示例

"timeRange": {
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "format": "date-time",
      "example": "2016-01-15T09:00:00.000Z"
    },
    "end_date": {
      "type": "string",
      "format": "date-time",
      "example": "2017-01-15T09:00:00.000Z"
    }
  },
  "required": ["start_date", "end_date"]
}
对于
[]
数组,您可以指定一个数组级别
示例
,它是一个多项目数组:

"timeRange": {
  "type": "array",
  "items": {
    "type": "string",
    "format": "date-time"
  },
  "example": [
    "2016-01-15T09:00:00.000Z",
    "2017-01-15T09:00:00.000Z"
  ]
}
无效的JSON–“时间范围”需要用引号括起来,并且对象/数组语法应该不同

如果使用对象语法
{}
,则需要将值命名为属性:

"timeRange": {
  "start_date": "2016-01-15T09:00:00.000Z",
  "end_date": "2017-01-15T09:00:00.000Z"
}
否则,
timeRange
需要是一个
[]
数组:

"timeRange": [
  "2016-01-15T09:00:00.000Z",
  "2017-01-15T09:00:00.000Z"
]

在第一个示例(
{}
对象)中,您的招摇过市看起来如下所示,每个命名属性都有一个单独的
示例

"timeRange": {
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "format": "date-time",
      "example": "2016-01-15T09:00:00.000Z"
    },
    "end_date": {
      "type": "string",
      "format": "date-time",
      "example": "2017-01-15T09:00:00.000Z"
    }
  },
  "required": ["start_date", "end_date"]
}
对于
[]
数组,您可以指定一个数组级别
示例
,它是一个多项目数组:

"timeRange": {
  "type": "array",
  "items": {
    "type": "string",
    "format": "date-time"
  },
  "example": [
    "2016-01-15T09:00:00.000Z",
    "2017-01-15T09:00:00.000Z"
  ]
}

非常感谢你。这正是我想要的。我一直在看斯威格的文档,但找不到类似的东西!非常感谢你。这正是我想要的。我一直在看斯威格的文档,但找不到类似的东西!