有没有一个公共网站可以将Swagger JSON转换为HTML的PDF文件？

Question

有人制作了这样的网站吗？你只需输入Swagger URL.../swagger/docs/v1，然后该网站将以易于阅读的漂亮格式将其转换为HTML、PDF、DOC或其他格式？我想那个网站会受到很多访问量（提示）。

我知道Github上有一些可以下载的工具可以进行转换，但我认为有人已经制作了一个公共网站，这样我就可以节省时间了。

- Dan Parker

---

相关：从Swagger API文档生成PDF - Helen

Answer 1

你可以使用这个网站： Swagger Editor，将你的swagger文件复制进去，在菜单中选择“生成客户端”->“HTML”（或动态HTML）。

如果你想在自动构建流程中添加这个步骤，也可以使用Swagger Code Generator。

- Nelson G.

---

那个生成的客户端看起来不太好看。 - Dan Parker

html2看起来非常完美（生成客户端-> html2），如果您想通过电子邮件与API消费者分享，可以将其打印到PDF文件中，使其更加友好。 - Shoaib Khan

如果这曾经起作用，现在已经不再起作用了。控制台现在只记录一个“TypeError: NetworkError when attempting to fetch resource.”错误。跨域请求被阻止：同源策略禁止读取远程资源... - Synctrex

Answer 2

试试这个：swagger2html。

由swagger-codegen生成的文档实际上是不可读的。这个项目采用了漂亮的外观（bootstrap css），并以直接的方式显示请求/响应模型中的字段。

- Jian Chen