Swagger 定制文檔

Question

有沒有辦法從 swagger 生成 README.md 文件？ 我想提供在 swagger web 頁面中可以找到的類似細節以及一些自定義評論。

另外，有沒有辦法制作一個聚合器 swagger web 頁面？ 我想將來自所有微服務的所有 swagger web 頁面也放在一個地方。 這可以讓我對我的系統有更高的了解，並且可能會做一些查詢，比如“某個實體可以通過多少方式獲得另一個實體？”。

Answer 1

關於 README.md 文件 - 不確定要在其中包含哪些信息，但您可以編寫自己的方法，該方法將使用Swagger Parser執行此操作，以便從 Swagger 規范中獲取所需信息。

關於聚合的 swagger - 您可以為此目的使用Swagger-aggregate 。