swagger-codegen-cli 将 v3 openapi.json 转换为静态 html

Question

我有一个 openapi.json 文件（在构建时生成），它是 v3 格式。我可以使用 swagger-codegen-cli 为 swagger 文档生成静态网站吗？

目标是在构建时同时生成 apidoc.json 和 html。

示例 CLI 命令？

以下命令错误提示我没有 swagger 输入：

java -jar ./lib/swagger-codegen-cli-2.2.1.jar generate -i src/main/resources/static/apidoc/openapi.json -l html2 -o target/generated-sources/swagger
[main] INFO io.swagger.parser.Swagger20Parser - reading from src/main/resources/static/apidoc/openapi.json
[main] INFO io.swagger.parser.Swagger20Parser - reading from src/main/resources/static/apidoc/openapi.json
Exception in thread "main" java.lang.RuntimeException: missing swagger input or config!
        at io.swagger.codegen.DefaultGenerator.generate(DefaultGenerator.java:132)
        at io.swagger.codegen.cmd.Generate.run(Generate.java:223)
        at io.swagger.codegen.SwaggerCodegen.main(SwaggerCodegen.java:36)

openapi.json 文件不以 "swagger" 开头。我需要转换它吗？这是它的开头：

{"openapi":"3.0.1","info":{"title"

Answer 1

Swagger Codegen v.2 不支持 OpenAPI 3.0。您需要使用 Codegen 版本 3.x.

您可以从 Maven Central 下载最新的 3.x CLI JAR：
https://mvnrepository.com/artifact/io.swagger.codegen.v3/swagger-codegen-cli

swagger-codegen-cli 将 v3 openapi.json 转换为静态 html

swagger-codegen-cli convert v3 openapi.json to static html

openapi

swagger-codegen