我有Koa/Express应用程序,并希望生成一个静态文档的基础上注解不同的API路线。Swagger看起来不错,但我发现的所有软件包都不生成文档,而是用API本身托管文档。我希望API文档与我的API分开。其他操作系统项目是否提供此功能?
gupuwyp21#
如果你已经有了OpenAPI/Swagger规范,你可以通过https://editor.swagger.io来尝试Swagger Codegen。在“生成客户端”下选择“HTML”或“动态HTML”或者你可以使用https://restunited.com来生成SDK和带有代码示例的文档。下面是一个示例:http://restunited.com/docs/6y2jvtvkgvst披露:我是Swagger Codegen的主要贡献者和RESTUnited.com的创始人
yrefmtwq2#
对于那些最近发现这个问题的人,这里是你可以使用的工具。它被称为TSOA:https://tsoa-community.github.io/docs/
2条答案
按热度按时间gupuwyp21#
如果你已经有了OpenAPI/Swagger规范,你可以通过https://editor.swagger.io来尝试Swagger Codegen。在“生成客户端”下选择“HTML”或“动态HTML”
或者你可以使用https://restunited.com来生成SDK和带有代码示例的文档。下面是一个示例:http://restunited.com/docs/6y2jvtvkgvst
披露:我是Swagger Codegen的主要贡献者和RESTUnited.com的创始人
yrefmtwq2#
对于那些最近发现这个问题的人,这里是你可以使用的工具。它被称为TSOA:https://tsoa-community.github.io/docs/