rest - Swagger 同一 Json 规范中的多个主机

Question

我正在使用单个主机来记录 Swagger Ui 2.0 中的 REST API，但我需要在 JSON 文件中使用两个主机来调用 rest API，一个用于 http，另一个用于 https。是否可以？如果是，那么该怎么做？

谢谢!

Answer 1

swagger 计算 URL 的方式是这样的:

您在生成 swagger.json 的 index.html 中提供基本的。生成的 swagger.json 本身不包含 URL，也不包含任何 http/https 信息。它只有一个相对于您提供的基本 URL 的路径。

根据生成的 swagger.json 生成 UI 后，“试用”按钮会根据地址栏中的 URL 信息执行 GET/POST/PUT 请求。在您的 swagger-ui.js 中检查这段代码:
if (url && url.indexOf('http') !== 0) {
url = this.buildUrl(window.location.href.toString(), url);
}

因此，如果您想使用 https，请在地址栏中使用 https 来点击 Swagger UI。您还需要在 index.html 和上述代码中的 swagger-ui.js 中提及相同内容。