昂首阔步的工具仅使用json格式

时间:2018-08-28 11:41:38

标签: node.js swagger swagger-ui swagger-tools

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

1 个答案:

答案 0 :(得分:0)

根据OpenAPI Specification(强调我的意思):

  

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

Swagger UI可以处理JSON和YAML定义。其他与OpenAPI相关的工具也应该-前提是它们使用YAML解析器。从技术上讲,YAML是JSON的超集,因此使用YAML解析器(而不是JSON解析器)的工具可以解析YAML和JSON。