当提供支持多个 API 规范的预生成链接时，Swagger UI 不会加载规范

Question

我有一个用 Go 编写的服务，它也使用 go 模板作为前端。该服务被我们的外部第三方用作查找资料和搜索的门户。还有另一个服务是用于处理订单的休息 API。门户服务有一个页面，您可以在其中查找 API 文档。我只有一个 API 版本，我使用 SwaggerUI 来显示 API 文档。我必须创建一个新端点并使其成为新 API 版本的一部分。现在我想展示一个新的 API 版本，以及支持旧客户端的旧版本。像这样的东西： 所以当用户点击门户网站上的按钮查看文档时，请求由门户中的这个函数处理（注意：我已经重构了这个函数以支持多个 url）：func getDocs(c echo.Context) error {    source := c.Get(auth.SourceName).(string)    key := c.Get(auth.KeyName).(string)    jsonURLs := []DocsURL{        {            url:         fmt.Sprintf("%s/0.1/docs?source=%s", config.baseURL, key),            name:        "0.1"        },        {            url:         fmt.Sprintf("%s/1.0/docs?source=%s", config.baseURL, key),            name:        "0.1"        },    }    return c.Render(http.StatusOK, "docs/index", map[string]interface{}{        "source":   source,        "key":      key,        "pageType": "docs",        "jsonURLs": jsonURLs,    })}这是我使用 SwaggerUI 的模板中的脚本：  window.onload = function() {    const ui = SwaggerUIBundle({      urls: {{ .jsonURLs }},      dom_id: '#swagger-ui',      deepLinking: true,      presets: [        SwaggerUIBundle.presets.apis,        SwaggerUIStandalonePreset      ],      plugins: [        SwaggerUIBundle.plugins.DownloadUrl      ],      layout: "StandaloneLayout",      supportedSubmitMethods: []    })    window.ui = ui    $('.tryitout').prop('disabled', true);  }我需要根据环境（生产、登台、本地）生成链接。在后端生成数据并将其提供给模板进行显示也是有意义的。但这不起作用！但是，如果我对链接中的链接进行硬编码，SwaggerUIBundle它可以工作，并且门户网站会显示正确的下拉菜单，并允许在版本之间切换并加载相应版本的文档。func getDocs(c echo.Context) error {    source := c.Get(auth.SourceName).(string)    key := c.Get(auth.KeyName).(string)    return c.Render(http.StatusOK, "docs/index", map[string]interface{}{        "source":   source,        "key":      key,        "pageType": "docs",    })}这是为什么？有没有办法让第一个版本的代码工作？我需要链接是动态的，最好在处理程序中生成。谢谢！

Answer 1

似乎有两个错误：

第一的：

  urls: {{ .jsonURLs }},

这不会jsonURLs为您以 JSON 格式编写。它会简单地写一个字符串表示jsonURLs。要么您需要编写模板来迭代其中的元素jsonURLs并一一打印出来，要么jsonURLs自己编组到 json：

jsonText,_:=json.Marshal(jsonURLs)

return c.Render(http.StatusOK, "docs/index", map[string]interface{}{

        "source":   source,

        "key":      key,

        "pageType": "docs",

        "jsonURLs": string(jsonText),

    })

第二：看起来你没有导出DocsURL结构的成员字段。将字段名称大写并添加 json 标签。

type DocsURL struct {

  URL string `json:"url"`

  Name string `json:"name"`

}