[英]swagger-ui how to form multiple responses in schema array
我正在尝试以这种格式形成一个庞大的文档。 响应是200 http代码上的以下json。 我无法形成如下所示的json。
[
{
"key":"test1",
"val":"val1"
},
{
"key":"test2",
"val":"val2"
},
{
"key":"test3",
"val":"val3"
}
]
到目前为止,我有这个:
"responses": {
"200": {
"description": "response",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/res1",
"$ref": "#/definitions/res2"
}
}
}
}
"definitions": {
"res1": {
"type": "object",
"properties": {
"key": {
"type": "string",
"example": "test1"
},
"keyURL": {
"type": "string",
"example": "val1"
}
}
},
"res2": {
"type": "object",
"properties": {
"key": {
"type": "string",
"example": "test2"
},
"val": {
"type": "string",
"example": "val2"
}
}
}
但是我根本看不到res2
块。 我只看到res1
JSON指针( $ref
)必须“单独”存在于对象中。 因此,您的items
块中不能有多个指针:
"$ref": "#/definitions/res1",
"$ref": "#/definitions/res2"
将忽略第二个参考( res2
),仅应用第一个。
对于您想做的事情,您有很多选择。 最简单的可能是这样的:
type: array
items:
$ref: '#/definitions/Pair'
并具有如下定义:
definitions:
Pair:
properties:
key:
type: string
value:
type: string
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.