Linux 下 Postman 接口分享的常用方式
- 通过链接分享集合：适合临时协作或对外只读分享。
- 导出/导入集合文件：适合离线、内网或版本管理场景。
- 发布在线文档：生成可公开访问的 API 文档页面。
- 团队工作区协作：适合长期团队开发、权限可控与变更同步。
以上方式在 Linux 桌面版的 Postman 中均可使用，界面与快捷键与操作系统无关。
操作步骤
-
准备与组织接口
- 创建并整理 Collection（集合），为每个接口补充 描述、参数、示例响应，便于他人理解与复用。
-
方式一 通过链接分享（只读或可被 fork）
- 在集合侧边栏或集合菜单中选择 Share → Get Public Link（获取公共链接）。
- 将链接发送给协作者，对方在 Postman 中 Import → Paste/Import from Link 即可导入到其工作区。
- 适合快速分享与评审，权限通常为只读，具体取决于你的分享设置。
-
方式二 导出/导入集合文件（离线/内网/版本管理）
- 在集合详情页点击 Export（导出），选择 Collection v2 格式并保存为 .json。
- 将 .json 文件通过邮件、代码仓库或内网文件服务共享。
- 接收方在 Postman 中 Import → Upload Files 导入即可使用。
- 提示：导出的集合不包含环境变量；如需共享环境，可单独导出 Environment 并在导入后配置变量。
-
方式三 发布在线文档（对外可读）
- 在集合选项中选择 View in Web（在线预览） 查看文档。
- 点击 Publish（发布），生成可在互联网访问的文档页面，便于外部开发者查看与检索。
- 后续更新集合后，发布页可按需同步更新。
-
方式四 团队工作区协作（长期协作与权限管理）
- 在 Postman 中创建 Team（团队） 并 邀请成员 加入。
- 将集合 Share（共享） 到团队工作区，并按需设置 编辑/查看/管理 等权限。
- 团队成员可在同一工作区协作，变更 自动同步；Postman 提供 版本控制 以合并更改与解决冲突。
权限与版本控制要点
- 公共链接通常为 只读，适合评审与临时使用；长期协作建议使用 团队工作区 并配置细粒度权限。
- 免费版团队在 自动同步 与协作上有次数/额度限制，超过后将影响同步能力。
- 使用 版本控制 管理集合变更，便于多人协作时的 合并与冲突解决。
常见问题与排查
- 导入后请求不通：多为 环境变量 未配置。将域名等抽象为变量（如 {{host}}），并在接收方环境或全局变量中设置实际值。
- 导出的集合缺少环境：集合导出不包含变量；需单独导出 Environment 或提供变量说明文档。
- 链接分享无法编辑：公共链接默认只读；需要可编辑权限时，请使用 团队工作区共享 并赋予相应角色。