hoppscotch支持从postman、insomnia、openapi、远程url及curl五种来源导入api数据:依次为导出json文件上传、自动识别格式、解析规范生成请求、拉取远程原始内容、还原curl命令为图形化请求。

如果您正在使用Postman、Insomnia或OpenAPI规范文档等第三方工具管理API集合,但希望将数据迁移到Hoppscotch中继续使用,则需借助其多格式兼容的导入能力。以下是完成跨工具数据迁移的具体操作步骤:
一、导入Postman集合文件
Postman导出的JSON格式集合可被Hoppscotch原生解析,保留全部请求方法、URL、Headers、Body及文件上传配置。该方式适用于v2.0与v2.1版本导出文件。
1、在Postman中打开“Collections”面板,点击目标集合右侧的“⋯”菜单。
2、选择“Export”,在弹出窗口中勾选“Collection v2.1(recommended)”。
3、点击“Export”并保存为本地JSON文件。
4、在Hoppscotch界面点击左侧导航栏的“Collections”,再点击右上角“Import/Export”按钮。
5、选择“File Import”,点击“Choose Files”,上传刚保存的Postman JSON文件。
6、等待解析完成,确认请求列表已完整载入,所有请求参数、认证设置和预请求脚本均被保留。
二、导入Insomnia导出文件
Insomnia导出的JSON文件结构与Postman高度相似,Hoppscotch通过统一解析器支持其直接导入,无需中间转换。
1、在Insomnia客户端中,右键点击目标Workspace或Collection。
2、选择“Export Data”,导出格式保持默认JSON,保存至本地。
3、进入Hoppscotch的“Import/Export”界面,切换至“File Import”选项卡。
4、点击“Choose Files”,选取Insomnia导出的JSON文件。
5、系统自动识别为Insomnia格式并启动解析流程。
6、导入完成后,请求路径、变量引用(如{{baseUrl}})及环境上下文将被正确映射。
三、导入OpenAPI(Swagger)规范文件
OpenAPI 3.0+ YAML或JSON格式的API契约文档可被Hoppscotch转化为可执行的请求集合,适用于从设计优先(Design-First)流程迁移的团队。
1、确保OpenAPI文件为合法格式:YAML需缩进正确,JSON需无语法错误,且包含paths字段。
2、在Hoppscotch中点击“Import/Export”,选择“File Import”。
3、拖入或点击选择OpenAPI文件(支持.yaml、.yml、.json扩展名)。
4、系统检测到OpenAPI标识后,自动启用规范解析引擎。
5、在导入预览界面中,可查看将生成的集合名称、请求数量及是否启用示例值。
6、点击“Import”,每个path+method组合将生成独立请求,参数自动填充为query/body/schema定义的示例值。
四、通过URL导入远程API规范
当OpenAPI文档托管于GitHub Gist、GitLab Snippet或企业内网文档服务时,可跳过下载步骤,直接拉取最新版本。
1、获取目标OpenAPI文档的原始内容URL(例如GitHub Gist需点击“Raw”按钮后的链接)。
2、在Hoppscotch“Import/Export”界面,切换至“URL Import”选项卡。
3、在输入框中粘贴该原始URL,确保以https://开头且返回Content-Type为application/yaml或application/json。
4、点击“Fetch & Import”,系统发起GET请求并校验响应状态码与MIME类型。
5、成功获取后,显示文档摘要信息,包括info.title与服务器地址。
6、确认无误后点击“Import”,导入结果将实时同步远程变更,避免本地文件过期问题。
五、导入cURL命令行指令
cURL是通用性最强的API描述方式,Hoppscotch支持单条或多条cURL命令的图形化还原,适用于从终端日志或文档片段快速重建测试用例。
1、复制一条标准cURL命令(必须含-X METHOD及URL,推荐包含-H头信息)。
2、在Hoppscotch中点击左上角“Import”按钮,选择“cURL”选项。
3、在文本区域粘贴cURL命令,支持换行分隔多条命令。
4、点击“Import”,系统调用内置cURL解析器提取HTTP方法、URL、Headers、Data及Cookie。
5、解析完成后,每条cURL生成一个独立请求条目。
6、Authorization头、Content-Type、JSON body及表单数据将被自动识别并填入对应字段。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











