问题陈述:
由于某种“奇怪”的原因,我们所有的API操作都有不同的“主机”。我们有如下API:
- 操作1:GET https://host1:port1/api/resources
- 操作2:GET 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}”级别上覆盖“主机”和“basePath”是否有意义?
2/ 是否有人已经尝试在swagger-ui中实现这个功能?
3/ 我能/应该向OpenAPI提出这种改变吗?
欢迎提出任何其他有用的意见/评论 ;-)