覆蓋「主機」和「基本路徑」，在「/ {}路徑」級

Question

問題陳述：

對於一個「奇怪」的原因，我們的API的所有操作都有不同的「主人」。我們有這樣的API：

• 操作1：GET https：//開頭主機1：端口1/API /資源
• 操作2：GET https：//開頭主機1：端口2/API /資源/（編號）
• 操作3：POST https：//開頭主機2：端口3/API /資源
• 操作4：POST https：//開頭主機2：4/API /資源/搜索

如果我們用揚鞭/ OpenAPI的作爲這意味着，它意味着爲每個操作創建一個Swagger/OpenAPI規範，從而導致每個操作都有一個swagger-ui頁面然後，需要重新創建一個索引頁面來列出API的所有操作： - /這正是我們想要避免的。

問題：

1 /此功能 - 在 「/ {}路徑」 級替換 「主機」 和 「基本路徑」 - 有意義嗎？

2 /有人已經嘗試在swagger-ui中實現此功能嗎？

3 /可以/我應該向OpenAPI提出這種改變嗎？

任何其他有用的言論/評論，歡迎;-)

Answer 1

在此不招搖2.0規範的支持。它將被添加到下一個版本，所以沒有必要添加建議！看到這裏：

https://github.com/OAI/OpenAPI-Specification/issues/562