node.js - swagger 工具是否只使用 json 格式

Question

我在我的 nodejs API 的 API 文档中使用 swagger。但作为一个初学者，我不知道 swagger ui。我用谷歌搜索它并找到了一个解决方案，它是 swagger 工具，但在 swagger 工具文档中他们使用 json 格式，但我的问题是我们不能使用 swagger.yaml (YAML) 格式来做同样的事情。

Answer 1

根据OpenAPI 规范（重点是我的）：

符合 OpenAPI 规范的 OpenAPI 文档本身就是一个 JSON 对象，可以用 JSON 或 YAML 格式表示。

Swagger UI 可以处理 JSON 和 YAML 定义。其他与 OpenAPI 相关的工具也应该使用 - 只要它们使用 YAML 解析器。从技术上讲，YAML 是 JSON 的超集，因此使用 YAML 解析器（而不是 JSON 解析器）的工具可以同时解析 YAML 和 JSON。