Hoppscotch：开源 API 开发与测试生态指南

是什么

Hoppscotch 是一款开源的 API 开发与测试生态工具，旨在帮助开发者更高效地构建、测试和管理各类软件接口。在现代计算体系中，应用程序编程接口（API）就像一座结构化的通信桥梁，让不同的软件应用能够跨网络顺畅地交换数据。Hoppscotch 则为工程师提供了一个集中的工作环境，大家可以在其中组装网络请求、发送到目标端点，并清晰直观地检查返回的数据结果。

根据其代码仓库的元数据介绍，Hoppscotch 将自身定位为 Postman 与 Insomnia 等流行工具的开源替代品。该项目采用宽松的 MIT License 协议，在 GitHub 上由开源社区共同协作开发。软件拥有一套简洁、克制的用户界面，设计初衷是保持轻量且不具干扰性，让用户能够把精力完全集中在 API 调试与交互上，免受冗杂界面的困扰。

在系统架构上，Hoppscotch 展现出了极高的灵活性。它支持多种客户端形态，包括无需安装的网页端（Web）、原生桌面应用程序以及命令行工具（CLI）。根据个人或企业的不同需求，Hoppscotch 既可以直接使用官方托管的云端服务，也支持部署在私有基础设施（本地自建部署）上，甚至能够完全离线使用。此外，它还可以作为渐进式 Web 应用（PWA）安装使用——借助后台的 Service Worker 技术，在桌面或移动设备上均可实现快速启动、离线运行，并能直接添加至系统主屏幕。

能做什么

Hoppscotch 具备全面的功能体系，覆盖了日常请求调用、实时通信协议、自动化脚本测试以及团队协作等多个维度。

RESTful API 请求与 HTTP 方法

Hoppscotch 支持开发者使用标准 HTTP 方法与各类 RESTful Web 服务进行交互，精准表达对服务器资源的操作意图：

• GET：检索指定资源的信息，不会对服务器数据产生变更。
• POST：向服务器提交新数据，通常用于在数据库中创建新记录。
• PUT：使用传入的完整内容替换目标资源。
• PATCH：对既有资源实施局部修改。
• DELETE：移除指定的资源或其关联组件。
• HEAD：获取与 GET 请求完全一致的响应头信息，但不拉取正文内容。
• CONNECT：与目标资源所在的服务器建立网络通信隧道。
• OPTIONS：查询目标端点支持的通信机制与功能约束。
• TRACE：沿着通往目标资源的网络路径执行回环消息测试。
• 自定义方法：支持用户自定义 HTTP 谓词（例如 LIST），以灵活兼容非标准接口。

用户可以在界面中配置请求参数、自定义 HTTP 标头以及请求体。请求体支持 JSON、FormData 和 Raw 原生输入等多种格式，并允许在键值对表单与纯文本视图间随意切换。响应检查面板能够清晰展示状态行、响应标头和响应体；内置的响应查看器为 JSON、XML、HTML 和图像提供了原生及格式化预览，同时支持直接复制到剪贴板或另存为本地文件。

实时与事件驱动协议

除常规的 REST 调用外，Hoppscotch 还为事件驱动与流式通信打造了专属操作界面：

• WebSocket：基于单条 TCP 连接建立持久的双工通道，支持客户端与服务端之间双向即时收发消息。
• Server-Sent Events（SSE）：通过标准 HTTP 连接持续监听服务端主动推送的实时事件流，免去了客户端反复轮询的负担。
• Socket.IO：提供与 Socket.IO 服务端之间的双向数据收发交互能力。
• MQTT：通过连接至 MQTT Broker 上的指定主题，完整支持物联网（IoT）场景中广泛应用的发布/订阅通信模型。

GraphQL 查询

针对专为按需取数而设计的 GraphQL 语言与运行时环境，Hoppscotch 提供了定制化的开发工具。用户连入 GraphQL 端点后，工具可自动抓取 Schema 架构、支持浏览多栏形式的 Schema 文档、配置自定义请求头、基于该结构编写查询，并直观呈现格式化的返回数据。

身份验证与安全

为了便于管理访问权限并模拟授权场景，Hoppscotch 预置了多种常见认证方案：

• 基于用户名与密码的 Basic Authentication 基础认证；
• Bearer Token 令牌；
• OAuth 2.0 完整授权流程；
• 采用 PKCE（Proof Key for Code Exchange，一种保护授权码交换安全的技术）的 OpenID Connect（OIDC）访问令牌；
• 企业版（Enterprise Edition）专属提供的单点登录（SSO）能力。

脚本、自动化测试与环境配置

Hoppscotch 支持使用 JavaScript 编写自定义逻辑，实现自动化请求处理与测试断言：

• 前置脚本（Pre-Request Scripts）：在发送网络请求之前执行的代码片段。可用于初始化或修改环境变量、在请求头中动态插入时间戳、生成随机参数，或是运行任意自定义的 JavaScript 运算。
• 后置测试（Post-Request Tests）：收到响应后立即触发的脚本。常用于判断 HTTP 状态码是否符合预期数值、筛选并校验响应头、解析返回的数据载荷，以及反向更新环境变量。
• 环境与变量（Environments and Variables）：支持创建无上限的环境与变量，便于在不同请求之间复用各类参数。变量既可以通过前置脚本动态赋值，也可以用换行分隔的键值对形式批量编辑，并支持通过文件或 GitHub Gist 轻松导入导出。

团队协同、扩展生态与个性化定制

• 集合与工作区（Collections and Workspaces）：支持将请求分类收纳进层级无限制的嵌套文件夹中。用户既可以管理私密的个人工作区，也能建立不限成员数量的团队工作区，享受集合共享、基于角色的权限控制（RBAC）以及跨设备的云端数据同步。
• 代理模式与浏览器扩展：现代浏览器默认遵循跨域资源共享（CORS）策略，会限制网页直接向外部域名发送请求。Hoppscotch 提供了官方代理服务（Proxyscotch）以及适用于 Google Chrome 和 Mozilla Firefox 的官方浏览器扩展，可轻松绕过 CORS 跨域壁垒、调试非 HTTPS 端点并隐藏客户端 IP 地址。
• 代码生成与请求共享：支持一键将调试好的请求导出为十余种编程语言与框架的可运行代码片段，支持通过公开链接共享请求，也能直接导入 cURL 命令。
• 个性化界面配置：项目 README 强调其具备轻盈迅速的特点，可实现毫秒级的请求派发与结果呈现。界面支持浅色（Light）、深色（Dark）、纯黑（Black）及随系统自动切换的主题，搭配 9 种强调色、无干扰的禅意模式（Zen mode）、丰富键盘快捷键，并拥有社区贡献的多语言本地化（i18n）翻译。

怎么开始

上手 Hoppscotch 十分简便，只需挑选中意的客户端并发出第一个调用：

1. 选择适合的客户端形态：

   • Web 网页版：直接在任意浏览器中访问 hoppscotch.io，免安装即开即用。
   • 桌面应用：下载独立的桌面安装程序，适用于 macOS、Windows 及 Linux。
   • 渐进式应用（PWA）：在浏览器中打开网页端后，将其添加至系统主屏幕或安装为桌面 PWA，随时离线使用。
   • 命令行工具（CLI）：利用官方 Hoppscotch CLI，直接在终端界面或 CI/CD 自动化流水线中运行批量测试集合。

2. 发送你的首个请求：

   • 在主界面顶部的下拉菜单中选择所需的 HTTP 方法（如 GET）。
   • 在地址栏中粘贴或输入目标 API 的完整 URL。
   • 点击 “Send” 按钮发起网络调用。
   • 在下方区域即时查看返回的状态码、响应标头与响应正文。

3. 配置跨端数据同步（可选）： 你可以免登录直接匿名使用，也可以选择登录账户，以便在多台设备间无缝同步工作区、集合、环境变量、历史记录和个性化配置。登录途径涵盖 GitHub、Google、Microsoft 账号及电子邮箱。

4. 化解浏览器跨域报错： 如果使用网页版调试外部接口遭遇 CORS 报错，可通过安装官方提供的 Chrome 或 Firefox 浏览器插件予以解决，亦可在软件设置中打开代理模式（Proxy Mode）。

5. 私有化自托管部署： 若团队或企业需要私有化运行环境，可依据官方文档指引，选择社区版（Community Edition）或企业版（Enterprise Edition）部署在自有的服务器与云基础设施之上。

价格与门槛

具体的计费模式、套餐版本以及企业级服务可能会有所调整，最新详细规则请以 Hoppscotch 官方网站（https://hoppscotch.io）与官方文档（https://docs.hoppscotch.io/）为准。

Hoppscotch 的核心代码属于完全开源软件，采用极具包容性的 MIT License 发布。在自托管部署场景下，主要分为两个梯度版本：

• 社区版（Community Edition）：开源免费的自托管版本，包含完整的核心 API 开发与测试功能。
• 企业版（Enterprise Edition）：面向企业客户的自托管版本，额外加入了单点登录（SSO）集成以及后台管理仪表盘等企业级控制特性。

各平台的运行门槛与系统兼容性如下：

• 桌面端：全面兼容 macOS、Windows 与 Linux 操作系统。
• Web 端与 PWA：支持各类支持 Service Worker 的现代主流浏览器。项目 README 提到，其 PWA 架构对运行内存（RAM）和处理器（CPU）资源的开销极低。
• CLI 命令行：可在标准终端环境以及各类持续集成（CI/CD）自动化构建流程中直接运行。
• 配套辅助组件：官方配备适用于 Google Chrome 和 Mozilla Firefox 的扩展插件；同时提供可独立部署的 Proxyscotch 代理服务器，协助完成网络路由转发与跨域兼容处理。

适合谁

Hoppscotch 能够满足软件研发链路上多种专业角色与团队的工作需求：

• 后端与 API 开发工程师：负责设计、调试和验证 RESTful 接口、GraphQL 架构以及各类实时通信协议（如 WebSocket、Server-Sent Events、Socket.IO 和 MQTT）的技术人员。
• 前端开发人员：需要在浏览器或桌面端直观检查数据结构、调试授权登录逻辑，或快速导出各语言调用代码的开发者。
• 测试工程师（QA）与 DevOps 运维专家：希望在 CI/CD 自动化流水线中利用命令行工具静默执行 API 测试套件的专业人士。
• 产研协作团队：需要集中统一工作区、多层级文件夹组织、细粒度权限控制以及多终端即时云同步的工程组织。
• 注重数据隐私与合规的企业：因监管法规或严格内部数据治理要求，必须将接口与调试数据完整保留在内网私有设施中，或需要完全离线运行的组织机构。

替代品

• Bruno 是一款开源的 API 客户端与接口测试平台。
• Insomnia 是一款用于设计、调试和测试 API 的开源应用程序。

来源

• https://github.com/hoppscotch/hoppscotch
• https://docs.hoppscotch.io/
• https://github.com/usebruno/bruno
• https://github.com/Kong/insomnia