有没有支持OpenAPI 3的生成器?

时间:2017-09-19 02:39:06

标签: swagger openapi openapi-generator

在撰写本文时,OpenAPI 3规范相对较新。我正在努力寻找支持3.0版本的任何文档生成器。

有没有人知道支持OpenAPI v3.0的生成器?

4 个答案:

答案 0 :(得分:11)

您可以尝试OpenAPI Generator(https://openapi-generator.tech),它支持OpenAPI规范v2,v3,并在几天前发布了稳定版本(3.0.0)。

使用docker,您可以轻松生成API文档:

docker run --rm -v ${PWD}:/local openapitools/openapi-generator-cli generate \
    -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
    -g html2 \
    -o /local/out/html2

答案 1 :(得分:3)

您可以在GitHub上找到的OAI Implementations document中找到精选的工具和库列表。

答案 2 :(得分:1)

要添加的一些新进展:

  • RepreZen API Studio现在支持上述William所引用的OpenAPI-Generator。 (注意:我为RepreZen工作。)
  • OpenAPI.Tools是与OpenAPI v3兼容的编辑器,生成器,文档格式和其他工具的又一绝妙资源。

答案 3 :(得分:0)

晚了一点,我发现它对于node.js Express项目非常有用

oas-generator (用于Open API 3.0规范):Link