集合是Hoppscotch中组织和复用API请求的核心单元,支持创建、添加请求、文件夹分组、导入导出及团队共享。

如果您希望在Hoppscotch中高效组织和复用API请求,集合(Collection)是核心管理单元。通过集合,您可以按项目、模块或功能对请求进行结构化归类,并实现一键复用与团队共享。以下是具体操作步骤:
一、创建新集合
集合是Hoppscotch中组织请求的基础容器,支持无限嵌套文件夹,便于构建清晰的API目录结构。创建集合后,所有相关请求均可归属其中,提升可维护性与协作效率。
1、点击左侧边栏顶部的「Collections」按钮,展开集合管理区域。
2、点击右上角「+ New Collection」按钮,弹出新建集合表单。
3、在「Name」字段中输入集合名称,例如用户服务-API测试;可在「Description」中添加简要说明,如“包含用户注册、登录、信息查询等全部端点”。
4、点击「Save」完成创建,该集合将立即显示在「My Collections」列表中。
二、在集合内添加请求
向集合添加请求是构建可复用测试流程的关键步骤。每个请求可独立配置方法、URL、Headers、Body及预处理脚本,且保存后自动关联至所属集合,支持后续批量执行与导出。
1、在右侧请求编辑区,填写目标API地址,例如https://reqres.in/api/users/2。
2、选择HTTP方法(如GET),保持其他参数默认或按需设置。
3、点击请求区域右上角的向下箭头图标,选择「Save Request」。
4、在弹窗中为该请求命名,例如获取单个用户信息;从下拉菜单中选择目标集合,确认后点击「Save」。
三、使用文件夹对集合进行分组
当集合内请求数量增多时,文件夹可进一步细化分类逻辑,例如按版本(v1/v2)、业务域(认证/订单/通知)或测试类型(正向/异常)划分,避免平铺导致的查找困难。
1、在已创建的集合名称右侧,点击「⋯」更多操作按钮。
2、选择「Add Folder」,输入文件夹名称,例如认证相关接口。
3、保存后,该文件夹即出现在集合下方;拖拽已有请求至该文件夹内,即可完成归类。
4、支持多层嵌套:在文件夹内再次点击「⋯」→「Add Folder」,创建子文件夹。
四、导入与导出集合
集合支持标准JSON格式导入导出,适用于备份、迁移、跨环境同步或团队协作场景。导出内容包含全部请求配置、文件夹结构及变量引用关系,确保完整还原。
1、在集合右侧「⋯」菜单中,选择「Export Collection」,系统自动生成符合Hoppscotch Schema的JSON文件。
2、导出文件可保存至本地,或通过Git等工具纳入版本控制。
3、导入时,点击左侧「Collections」区域右上角「Import」按钮,选择本地JSON文件。
4、确认导入范围(仅当前集合或含全部依赖),点击「Import」后,集合及其全部子项将重建至当前工作区。
五、共享集合至团队空间
若已启用Hoppscotch团队空间(Team Workspace),集合可被授权共享,实现权限可控的协同测试。成员无需手动导入,即可实时查看、运行、编辑(依权限)同一套API集合。
1、进入目标集合的「⋯」菜单,选择「Share Collection」。
2、在弹窗中开启「Enable sharing」开关,系统生成唯一共享链接。
3、点击「Copy Link」复制链接,发送给团队成员;或在「Invite Members」中输入其注册邮箱并分配角色(Viewer / Editor / Admin)。
4、被邀请者登录后,该集合将自动出现在其「Shared with me」标签页下,且实时同步更新。

















