是否有將 openapi3 轉換為 Restdocs(adoc) 的解決方案？

Question

我可以使用 Swagger2Markup 將 openapi2 轉換為 adoc，但它僅支持 openapi2，不支持 3。

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

我讀了一些關於它的問題，我猜它仍然不支持 openapi3。 那么有沒有關於它的插件？

Answer 1

一種可能的解決方案是將您的 OpenAPI 3.0 定義轉換為 HTML/HTML2 文檔。

按着這些次序：

1. Go 至https://editor.swagger.io
2. 導入（文件-->導入）或粘貼您的 OpenAPI 3.0 YAML/JSON 定義。
3. Select 生成客戶端 > html 或 html2。
4. 下載並解壓縮文件。
5. 在瀏覽器中打開 index.html 頁面。