如何在Linux上使用Postman进行API文档生成

在Linux上使用Postman生成API文档，可参考以下方法：

使用Postman界面生成

1. 创建并组织API请求集合：打开Postman，创建新集合，添加API请求，为每个请求添加详细描述，包括请求方法、URL、参数等，还可添加成功、失败等示例响应。
2. 预览和发布文档：在集合选项中，点击“View in Web”可预览文档，点击“Publish Docs”可生成公开URL分享文档。

使用第三方工具导出

1. 安装docgen：通过命令wget https://raw.githubusercontent.com/thedevsaddam/docgen/v3/install.sh -o install.sh && sudo chmod +x install.sh && sudo ./install.sh && rm install.sh安装。
2. 导出文档：从Postman导出集合为JSON文件，再用docgen转换，如docgen build -i ~/Downloads/my_api.json -o ~/Downloads/my_api.html生成HTML文档。

使用Postman命令行工具

1. 安装Postman CLI：参考文档安装，如使用Snap安装sudo snap install postman。
2. 生成文档：使用newman run /path/to/postman_collection.json -e /path/to/postman_environment.json -o /path/to/output.html命令生成HTML文档。