swagger-ui - Swagger UI具有多个URL

Question

我在swagger ui文档中看到，您可以提供urls参数，该参数是：


Topbar插件使用的API定义对象（{url：“”，名称：“”}）的数组。使用并启用Topbar插件时，将不会解析url参数。名称和URL在此数组的所有项目中必须唯一，因为它们被用作标识符。


我希望这会给我一个选择器，从中我可以选择要处理的yaml文件。不幸的是，它似乎无能为力。

这是我的代码：

window.onload = function() {
  // Build a system
  const ui = SwaggerUIBundle({
    urls: [
    {url:"http://test.dev/documentation/microservices/microservices.yaml",name:"All Microservices"},
    {url:"http://test.dev/documentation/microservices/plans.yaml",name:"Plans"},
    ],
    dom_id: '#swagger-ui',
    presets: [
      SwaggerUIBundle.presets.apis,
      SwaggerUIStandalonePreset
    ],
    plugins: [
      SwaggerUIBundle.plugins.DownloadUrl
    ],
    layout: "StandaloneLayout"
  })

  window.ui = ui
}

我还想将primaryName设置为All Microservices。

关于我要去哪里的任何想法？

Answer 1

Swagger UI 3.0.18和更高版本支持urls配置选项。

您可以这样使用它而不是url：

window.onload = function() {
  // Build a system
  const ui = SwaggerUIBundle({
    urls: [
      {url: "https://path/to/api1.yaml", name: "Display name 1"},
      {url: "https://path/to/api2.yaml", name: "Display name 2"},
    ],
    ...
  })