Swagger UI具有多种服务

Question

有没有一种方法可以“聚合”（或至少链接到）多个Swagger API以在单个UI上显示？

假设我有两个服务Foo和Bar，我要做的是制作第三个服务Baz，它提供Foo和Bar的元数据。Foo，Bar和Baz将位于不同的主机上，这就是为什么我不确定是否可能的原因。

---

一种解决方案是使用服务发现的思想（在这种情况下可能不是正确的术语），并在执行GET时让Baz提供指向Foo和Bar的链接。

GET / HTTP/1.1
Host: baz
Accept: application/json
...

HTTP/1.1 200 OK
Content-Type: application/json
...

{
    "services": [
        {
            "name": "foo",
            "link": "http://foo"
        },
        {
            "name": "bar",
            "link": "http://bar"
        }
    ]
}

这就是我通常会采用的方式，但是我想知道是否有办法让Baz上的Swagger UI显示Foo和Bar的UI。

Answer 1

我最终要做的是在index.html文件中，用下拉列表替换页面顶部的文本框，该下拉列表具有指向托管swagger.json文件的各种服务器的链接。

<div id='header'>
  <div class="swagger-ui-wrap">
    <a id="logo" href="http://swagger.io">swagger</a>
    <form id='api_selector'>

      <!-- Start of my changes -->

      <div class='input'>
        <select placeholder="http://example.com/api" id="input_baseUrl" name="baseUrl" type="text">
          <option value="http://foo/swagger.json">Foo</option>
          <option value="http://bar/swagger.json">Bar</option>
        </select>
      </div>

      <!-- End of my changes -->

      <div class='input'><input placeholder="api_key" id="input_apiKey" name="apiKey" type="text"/></div>
      <div class='input'><a id="explore" href="#" data-sw-translate>Explore</a></div>
    </form>
  </div>
</div>

可以编写JavaScript脚本来与您的Eureka实例（或类似的实例）进行对话，以获取每个服务的网址，并且下拉列表可以自动更新。我不是JavaScript或HTML专家，所以我不知道该怎么做，但是我提到它是因为有可能。这将更加有用，因此您无需在每次添加新服务时都更新此文件。