有没有一种简单的方法可以从express-gateway服务生成API文档？

Question

有没有一种简单的方法可以从express-gateway服务生成API文档？例如使用swagger？在传统的方法中，文档是基于函数的注释生成的，而在express-gateway中，APIS是在gateway.config.yml文件中定义的，swagger不知道如何处理这一点。

Answer 1

这目前是不可能的。文档需要比Express Gateway yaml文件中存在的更丰富的信息，并且描述EG文件的模式不允许额外的信息。

理想情况下，应该有一个工具可以处理Swagger/OpenAPI规范并创建Express Gateway配置文件，但我还没有找到任何工具。