需先保存集合并确保导出权限,再通过收藏夹、集合管理界面、秘密gist三种方式导出json文件,导出前须验证完整性,导出后需清洗私有字段以保障cli兼容性。

如果您已完成API请求的组织与测试,希望将Hoppscotch中的集合导出为JSON文件并分享给团队成员,则需确保集合已保存且具备导出权限。以下是完成该任务的具体操作步骤:
一、通过收藏夹导出集合为JSON文件
收藏夹是Hoppscotch中持久化保存请求的核心容器,只有保存在收藏夹中的请求才能被导出为结构化JSON文件,该文件包含全部请求配置、测试脚本及元数据,适用于本地备份或跨工具迁移。
1、点击左侧导航栏中的收藏夹图标,进入收藏夹页面。
2、在收藏夹列表中,找到目标集合,点击其右侧的三个点(更多选项)按钮。
3、在弹出菜单中选择“导入/导出”选项。
4、在打开的模态框中切换至“导出”选项卡。
5、勾选“导出为JSON文件”,点击“导出”按钮,系统将自动下载一个以集合名称命名的.json文件。
二、使用集合管理界面直接导出
Hoppscotch的集合管理界面提供更细粒度的导出控制,支持单个集合或多个集合批量导出,且可保留文件夹结构和环境变量关联信息,适合需要完整保留组织逻辑的场景。
1、在左侧导航栏点击“Collections”进入集合列表。
2、右键点击目标集合名称,在上下文菜单中选择“Export”。
3、确认导出格式为Hoppscotch原生格式(.hopp)或JSON格式;若需CLI兼容,请优先选择JSON。
4、点击“Download”,文件将按系统默认下载路径保存。
三、通过秘密Gist分享集合链接
秘密Gist是一种无需登录第三方平台即可生成可共享链接的方式,导出内容以加密形式托管于GitHub Gist,仅持有链接者可查看,适合临时协作或敏感接口的受限分享。
1、进入目标集合的详情页,点击右上角“Share”按钮。
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
2、在分享面板中选择“Create secret Gist”选项。
3、输入Gist描述(可选),点击“Create”。
4、复制生成的Gist URL链接,发送给协作者;对方访问链接后可直接在Hoppscotch中点击“Import from Gist”导入。
四、导出前验证集合完整性
导出失败或JSON内容异常往往源于集合内部状态不一致,例如存在未保存的请求、损坏的测试脚本或非法环境变量引用。提前验证可避免导出后无法导入或CLI执行报错。
1、打开目标集合,逐个检查其中所有请求是否显示“Saved”状态标识。
2、点击任一请求,在测试脚本区域确认语法无红色波浪线报错,且所有{{variable}}引用均有对应环境定义。
3、在集合设置中查看“Environment”下拉菜单是否可正常展开并显示有效环境项。
4、如发现异常请求,先执行“Save”操作或删除无效条目,再进行导出。
五、处理导出后的JSON兼容性问题
导出的JSON文件可能因版本差异或字段冗余导致在Hoppscotch CLI或其他工具中解析失败,需对文件内容进行轻量级清洗,确保符合Zod schema校验规则,尤其适用于自动化测试流水线。
1、用文本编辑器打开导出的JSON文件,定位到根对象的“_type”字段,确认其值为"collection"。
2、删除顶层字段中以“__”开头的私有属性(如__meta、__exportedAt),这些字段仅用于Web界面渲染,CLI不识别。
3、检查每个请求对象内的“tests”数组,确保每项均为字符串格式的有效JavaScript断言表达式,不含注释或空行。
4、保存修改后的JSON文件,使用Hoppscotch CLI命令验证:hoppscotch test -c your-collection.json -e dev。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










