相关疑难解决方法(0)

我可以使用多个主机,例如:

host1: petstore.test.com
host2: petstore1.test.com
host3: petstore2.dev.com

现在我的YAML文件只有一个主机URL.

例如:

host: petstore.test.com
basePath: /

是否可以有多个（以某种方式分开的）REST API 文档，但只能在一个 swagger yaml 文件中？

或者 swagger yaml 可以只包含一个 API 文档吗？

因为我有 2 个由我开发的 REST API，并且我想要一个通用的 swagger ui 而不是两个，我可以使用像 Tyk 这样的网关来管理它。

问题陈述：

出于“奇怪”的原因，我们对一个 API 的所有操作都有不同的“主机”。我们有这样的 API：

• 操作 1：获取 https://host1:port1/api/resources
• 操作 2：获取 https://host1:port2/api/resources/{id}
• 操作 3：POST https://host2:port3/api/resources
• 操作 4：POST https://host2:port4/api/resources/search

如果我们照原样使用 Swagger/OpenAPI，就意味着每个操作创建一个 Swagger/OpenAPI 规范，导致每个操作有一个 swagger-ui 页面，然后，需要重新创建一个索引页面来列出一个操作的所有操作API :-/ 这正是我们想要避免的。

问题：

1/ 这个特性——在“/{path}”级别覆盖“host”和“basePath”——有意义吗？

2/ 是否有人已经尝试在 swagger-ui 中实现此功能？

3/ 我可以/应该建议对 OpenAPI 进行这种更改吗？

欢迎任何其他有用的评论/评论;-)