用于多个 RESTFul 服务的 Swagger UI

Question

我读了以下内容here :

Swagger does not currently include a suggestion for supporting multiple API versions from a client or server point of view—versioning information (both of the spec and the underlying API implementation) are declared.

我想知道的是如何配置 swagger UI 以显示多个服务的 API，即驻留在不同服务器上的服务。我尝试在不同的服务器上配置 swagger UI，但出现以下错误:

Can't read from server. It may not have the appropriate access-control-origin settings.

我已阅读有关在服务器上启用 CORS 的信息，但这对我的情况没有帮助，因为服务在 liberty 配置文件上运行。

Swagger UI 在本地运行的 WAS 自由配置文件上配置，服务在不同的 WAS 实例上运行。

我的方向是为多个服务提供 UI，但我认为这是一个逻辑起点。

Answer 1

Swagger 2 规范似乎很快就会允许这样做。看看这个似乎是贡献者的回复:

We're currently in the process of finalizing the ability to collate several micro-services into a single collection, but eventually, each micro-service is still going to be a single file.

https://stackoverflow.com/a/26917653/3389881

Swagger Google 群组中的同一个人评论: https://groups.google.com/forum/#!topic/swagger-swaggersocket/H7dsSd6VPvM

此人找到了一种将多个 Swagger 2 定义分组在同一位置的方法: http://utility-stack.apievangelist.com/index.html

最后，Swagger 1 似乎将支持多个 API 基本路径。