为 REST API 生成 YAML 或 JSON 文件

Question

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

Answer 1

YAML/JSON 只是一个文档，您无法通过包含此文件来实现它们，但您可以提供此文档，例如 {yourAPI}/swagger.yaml。