如何在swagger中定义空数组

Question

我知道如何在swagger中制作字符串数据数组,如下所示:

"photoUrls" : {
    "type":"array",
    "items":{
         "type":"string"
    }
}

它将显示如下输出:

"photoUrls":[
    "string"
]

如何制作这样的输出？:

"photoUrls":[]

Answer 1

您可以为阵列架构指定一个空数组[]作为example。这将覆盖Swagger UI生成的默认示例值。

"photoUrls" : {
    "type":"array",
    "items":{
         "type":"string"
    },
    "example": []
}

但是罗恩的答案对您的用户来说更加用户友好。考虑改用一些实际example值：

"photoUrls" : {
    "type":"array",
    "items":{
         "type":"string",
         "example": "http://example.com/images/pet.png"
    },
}

Answer 2

你没有.这个想法就是这样

"photoUrls":[
    "string"
]

显示您的用户photoUrls是一个字符串数组.否则,他们将无法知道数组使用的数据类型.