Swagger api-docs 到 swagger.json？答案

【问题标题】：Swagger api-docs to swagger.json?Swagger api-docs 到 swagger.json？
【发布时间】：2015-10-01 04:48:24
【问题描述】：

我正在使用 Spray 和最新版本的 spray-swagger (0.5.1)，我可以在 swagger-ui 中查看我的 API 文档。但是 spray-swagger 使用从 /api-docs 开始的分层目录结构...我想使用其他与 swagger 相关的工具，而这些工具似乎更喜欢单个 swagger.json 文件。

是否有任何工具可以将 /api-docs 分层目录结构转换为单个 swagger.json 文件？

【问题讨论】：

标签： swagger spray

【解决方案1】：

您可以使用Swagger Converter。这是他们页面中提供的示例：

var convert = require('swagger-converter');

var resourceListing = require('/path/to/petstore/index.json');

var apiDeclarations = [
  require('/path/to/petstore/pet.json'),
  require('/path/to/petstore/user.json'),
  require('/path/to/petstore/store.json')
];

var swagger2Document = convert(resourceListing, apiDeclarations);

console.log(swagger2Document);

【讨论】：

resourceListing 在 /api-docs 时这个功能可以吗？（127.0.0.1:8080/api-docs）我从节点收到以下错误：错误：找不到模块'127.0.0.1:8080/api-docs'
我不确定convert 函数是否支持 URL。如果没有，您必须在执行转换之前将文件（例如 api-docs）下载到本地驱动器。