json - swagger-ui 和动态主机名

Question

我有一个从模板动态生成的服务器，它公开了一个基于/api. 我只使用 HTTPS 访问它。如果我将其指定baseUrl为“/api”，swagger-ui 会尝试/api使用 HTTP 进行访问（并且我的浏览器会显示“锁定加载混合活动内容”）。

如果我给出https://hostname/api的basePath东西工作正常，但我不希望每个服务器的 JSON 文件都不同。

有任何想法吗？

谢谢，亚龙

Answer 1

即使OP已经找到答案，其他人也可能没有，所以我会尝试回答。您应该指定schemes属性（Swagger 2.0）：

{
  "swagger": "2.0",
  "schemes": [ "https" ]
}

Answer 2

如果您只是将该schemes属性留空，swagger-ui 将使用与访问swagger.json文件相同的方案。

从文档：

如果未包括方案，则要使用的默认方案是用于访问 Swagger 定义本身的方案。