是否有将 openapi3 转换为 Restdocs(adoc) 的解决方案？

Question

我可以使用 Swagger2Markup 将 openapi2 转换为 adoc，但它仅支持 openapi2，不支持 3。

https://github.com/Swagger2Markup/swagger2markup/issues

我读了一些关于它的问题，我猜它仍然不支持 openapi3。那么有没有关于它的插件？

Answer 1

一种可能的解决方案是将您的 OpenAPI 3.0 定义转换为 HTML/HTML2 文档。

按着这些次序：

1. 转到https://editor.swagger.io
2. 导入（文件-->导入）或粘贴您的 OpenAPI 3.0 YAML/JSON 定义。
3. 选择生成客户端 > html 或 html2。
4. 下载并解压缩文件。
5. 在浏览器中打开 index.html 页面。