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"
]
}
非常感谢你。这正是我想要的。我一直在看斯威格的文档,但找不到类似的东西!非常感谢你。这正是我想要的。我一直在看斯威格的文档,但找不到类似的东西!