使用swagger 4生成swagger 2.0 yaml。x包

Question

我将把我的API服务器集成到Google云endpoint。

谷歌云endpoint目前支持昂首阔步2.0。

但是我的依赖项/库现在是最新版本。因此，我希望生成swagger 2.0 yaml文件，而不降级swagger库版本（apiendpoint已经在swagger 4.x-openapi 3.0规范中描述）。

Nestjs和swagger依赖项（package.json）：

...

"@nestjs/common": "^7.0.0",
"@nestjs/config": "^0.4.0",
"@nestjs/core": "^7.0.0",
"@nestjs/platform-express": "^7.0.0",
"js-yaml": "^3.14.0",

...

"@nestjs/swagger": "^4.5.4",
"swagger-ui-express": "^4.1.4",

...

和大摇大摆生成器脚本：

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import * as fs from 'fs'
import * as yaml from 'js-yaml'

const generateSwaggerYaml = async () => {
  const app = await NestFactory.create(AppModule);
  const options = new DocumentBuilder()
    .setTitle('API Title')
    .setDescription('API Description')
    .build()

  const document = SwaggerModule.createDocument(app, options)

  fs.writeFileSync("./openapi-run.yaml", yaml.safeDump(document))
}


generateSwaggerYaml()

脚本输出为openapi 3.0规范：（

openapi: 3.0.0
info:
  title: API Title
  description: API Description.
  version: 1.0.0
  contact: {}
tags: []
servers: []

...

是否有任何选项/方法来生成虚张声势2。openapi 3.0文档中的0 yaml？

我怎么能降级openapi 3.0规格为昂首阔步2.0规格？

Answer 1

我使用github的这个项目就是为了这个目的：https://github.com/LucyBot-Inc/api-spec-converter

对于OpenAPI3YAML到swagger 2YAML，它就像$api规范转换器一样简单——从openapi_3——语法yaml——到swagger_2${f}