我在Postman中创建了一组包含多个API端点的集合。我可以将团队成员添加到我的Postman工作区,并且还可以公开共享文档链接。但我想要一个下载链接,以便将文档作为文件夹下载并添加到我的项目中。我是否错过了在Postman中提供此功能的相关设置?
您可以像其他答案中所示一样将集合导出为json,然后运行工具将其转换为HTML文档,您可以在任何地方托管它。
我创建了一个简单的Python可执行文件来完成这个任务 - https://github.com/karthiks3000/postman-doc-gen
Postman生成的API文档旨在通过工作区和URL进行共享和消费,以确保其保持最新状态并不会过时。由于文档很可能经常更新示例、新端点和其他元素,因此任何下载的内容都很快就会过时。我知道PDF版本已被讨论作为未来发布的一部分,但保持API文档最新是首要任务。
一个简单的解决方法是从网络浏览器中将页面打印为PDF格式。虽然不是完美的,但也可以使用。
https://learning.postman.com/docs/getting-started/importing-and-exporting-data/导出文档为JSON格式,然后运行@karthiks3000的脚本(https://github.com/karthiks3000/postman-doc-gen)