Swagger 定制文档

Question

有没有办法从 swagger 生成 README.md 文件？ 我想提供在 swagger web 页面中可以找到的类似细节以及一些自定义评论。

另外，有没有办法制作一个聚合器 swagger web 页面？ 我想将来自所有微服务的所有 swagger web 页面也放在一个地方。 这可以让我对我的系统有更高的了解，并且可能会做一些查询，比如“某个实体可以通过多少方式获得另一个实体？”。

Answer 1

关于 README.md 文件 - 不确定要在其中包含哪些信息，但您可以编写自己的方法，该方法将使用Swagger Parser执行此操作，以便从 Swagger 规范中获取所需信息。

关于聚合的 swagger - 您可以为此目的使用Swagger-aggregate 。