我想用swagger设计我的web API,但问题是我必须自己编写所有的yaml代码,这本身就是一个耗时又乏味的过程,这个过程能自动化吗?我试着搜索,但没有任何有用的东西。是自动生成的API设计的yaml代码甚至可能在创建api本身。如果yaml代码不能自动生成,为什么还要用swagger来设计API呢?任何帮助都将不胜感激。谢谢!
zbdgwd5y1#
你可以用swashbuckle来代替swagger(或者和它一起,但我建议只选一个)https://github.com/domaindrivendev/Swashbuckle.AspNetCore#getting-started自从我使用它以来,他们改变了文档,但是你可以使用这个工具来扫描你的asp.net核心项目,查看所有的控制器和路由,并为你生成一个opeapi文档。它还可以生成客户端代码和其他一些东西。
hzbexzde2#
对于开源代码生成工具来说,这听起来是个不错的想法,但我也没有找到任何现有的解决方案来支持你的建议,我也有同样的问题,但当我通读这篇文章时,我突然想到了一个主意:如果您有一个API,可以在开发过程中从CLI调用,该API将请求的格式与附加到基URL的自定义路由结合起来,将其视为路由定义的一种模式,并使用一个swagger.yml代码片段进行响应,该代码片段描述了将接受示例请求的自定义路由,情况会怎样?老实说,这听起来很可行。我想我会试着把它拼在一起。
2条答案
按热度按时间zbdgwd5y1#
你可以用swashbuckle来代替swagger(或者和它一起,但我建议只选一个)
https://github.com/domaindrivendev/Swashbuckle.AspNetCore#getting-started
自从我使用它以来,他们改变了文档,但是你可以使用这个工具来扫描你的asp.net核心项目,查看所有的控制器和路由,并为你生成一个opeapi文档。
它还可以生成客户端代码和其他一些东西。
hzbexzde2#
对于开源代码生成工具来说,这听起来是个不错的想法,但我也没有找到任何现有的解决方案来支持你的建议,我也有同样的问题,但当我通读这篇文章时,我突然想到了一个主意:
如果您有一个API,可以在开发过程中从CLI调用,该API将请求的格式与附加到基URL的自定义路由结合起来,将其视为路由定义的一种模式,并使用一个swagger.yml代码片段进行响应,该代码片段描述了将接受示例请求的自定义路由,情况会怎样?
老实说,这听起来很可行。我想我会试着把它拼在一起。