为 REST API 生成 YAML 或 JSON 文件

Question

我正在使用swagger来记录我的REST API。但是我在代码中使用了大摇大摆的注释，例如@API、@APIOperation等。但我不想添加这些注释。有没有办法为 REST API 生成 YAML 或 JSON 文件，然后使用这些文件来描述、记录和可视化 REST API。

Answer 1

YAML/JSON 只是一个文档，你不能通过包含这个文件来实现它们，但你可以提供这个文档，例如{yourAPI}/swagger.yaml.