swagger 从模式生成静态API文档?

pxy2qtax  于 9个月前  发布在  其他
关注(0)|答案(2)|浏览(85)

我有Koa/Express应用程序,并希望生成一个静态文档的基础上注解不同的API路线。
Swagger看起来不错,但我发现的所有软件包都不生成文档,而是用API本身托管文档。我希望API文档与我的API分开。
其他操作系统项目是否提供此功能?

gupuwyp2

gupuwyp21#

如果你已经有了OpenAPI/Swagger规范,你可以通过https://editor.swagger.io来尝试Swagger Codegen。在“生成客户端”下选择“HTML”或“动态HTML”
或者你可以使用https://restunited.com来生成SDK和带有代码示例的文档。下面是一个示例:http://restunited.com/docs/6y2jvtvkgvst
披露:我是Swagger Codegen的主要贡献者和RESTUnited.com的创始人

yrefmtwq

yrefmtwq2#

对于那些最近发现这个问题的人,这里是你可以使用的工具。它被称为TSOA:https://tsoa-community.github.io/docs/

相关问题