API 集合怎么组织：树形管理 公共参数与文档导出

集合（Collection）是 API 请求的「仓库」：把调好的请求按项目分门别类存起来，团队复用或自己下次接着用。

集合的结构

打开侧边栏「集合」面板（快捷键 F2）。集合里可以存放 HTTP 接口、WebSocket 接口和文件夹，按树形组织，树深度限制为 4 层。

三种保存入口

1. 保存当前 API：请求编辑页右上角保存图标（快捷键 Control + S），输入名称、选择存放位置；
2. 保存调试请求：调试列表右键 →「添加到」→「API 集合」（快捷键 Control + I），把抓到的请求直接入库；
3. 导入第三方集合：从 Postman 等工具整体迁移（见下一篇）。

数据存哪里

• 未登录账号：集合数据离线保存在设备本地，仅当前设备可访问；
• 登录账号后：可选择云端存储，多设备实时同步。

集合级公共配置

双击集合打开集合管理页面，这里的能力容易被忽略但很实用：

• 定义公共参数、请求头、脚本、授权，集合内所有 API 自动继承——改一处、全集合生效；
• 编写集合文档；
• 整体导出集合中所有 API 的文档（PDF 导出目前仅 Mac 系统可用）。

导出与分享

集合支持导出为 Reqable 格式（JSON）和 Postman 格式（JSON），见 导入第三方集合 中的格式对照。配合 环境变量，一份集合就能在多套环境间复用。