大摇大摆 api-docs 到 swagger.json？

Question

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

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

Answer 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);

大摇大摆 api-docs 到 swagger.json？

Swagger api-docs to swagger.json?

swagger

spray