数组标题未显示在 Swagger UI 模型中

Question

我有一个 Response object 和一个 Response object 数组 "title": "Responses"。但是 Responses 标题文本没有出现在 Swagger UI 的 Models 部分中。这是预期的还是我的 swagger 定义有问题？ 我正在使用 https://github.com/swagger-api/swagger-ui

的主分支

Swagger definition 部分：

    "Response": {
                "type": "object",
                "title": "Response",
                "description": "Response to query.",
                "properties": {
                    "Query": {
                        "$ref": "#/definitions/Query"
                    },
                    "Result": {
                        "$ref": "#/definitions/Result"
                    }
                }
            },
   "Responses": {
                "type": "array",
                "title": "Responses",
                "description": "Array of responses.",
                "items": {
                    "$ref": "#/definitions/Response"
                }
            }

Answer 1

这似乎是 Swagger UI 3.x 的问题。我有一个类似的 API 定义。它在 Swagger UI 2.x 中运行良好，但我在 3.x 中看到同样的问题。我不知道 Swagger UI 团队是否正在跟踪这个问题。

如果您等不及修复，您可能想要使用 the 2.x branch 的最新发行版。