Hoppscotch API 测试上手：3 步发出第一个请求-开发者社区

Hoppscotch API 测试上手：3 步发出第一个请求

【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem & Cloud • Web, Desktop & CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch

改参数要翻回文档、换 Token 要去配置里找、发完请求还得复制响应贴给同事——Hoppscotch 是一个免费开源的 API 测试工具，一个界面里发出 REST、GraphQL、WebSocket、SSE 等协议的请求，内置环境变量、请求集合与多种认证方式，常被当作 Postman、Insomnia 的开源替代品，适合任何要联调接口的开发者。

Hoppscotch 第一次发请求的最快步骤

打开 Hoppscotch（在线版或桌面版），不需要初始化配置也不需要账号，界面中间就是请求编辑区：从下拉里选GET、POST、PUT等请求方法，也可以直接输入自定义方法；
在URL栏填入接口地址，按需补充Query参数、Headers请求头和Body请求体，Body 支持键值对和 RAW 两种输入模式；
点Send（或按 Ctrl/Cmd + Enter），下方立刻显示状态码、耗时、响应头和格式化后的响应体。

零账号、零配置，第一次发送后请求会自动进入History历史，随时可以回看和重发。门槛基本就是"打开页面就能用"。

用 Hoppscotch 组织接口联调的三种场景

发 REST 请求与导入导出

REST是默认打开的页面，大多数接口联调都发生在这里。

Body页签可按 Content Type 切换 JSON、FormData、x-www-form-urlencoded 等格式；
响应区可以复制、下载，HTML、JSON、XML、图片都有预览；
左侧集合面板按文件夹组织请求，单个请求能导出为主流语言的代码片段；
支持直接粘贴 cURL 命令导入，不用手动搬字段。

举个例子：同事甩来一条 cURL，你粘进导入框、换掉 Token，就能直接发出。

接 GraphQL 与实时协议

左侧竖排入口可以切到 REST 之外的协议，不用另开工具。

GraphQL：填好 endpoint 后自动拉取 schema，自带文档面板，可以写查询并查看结果；
WebSocket / SSE / Socket.IO / MQTT：归在Realtime分组，分别对应长连接、服务器推送事件流、Socket.IO 事件和 MQTT 主题订阅发布。

举个例子：测 SSE 时不用自己写轮询代码，连接建立后消息按到达顺序展示在面板里。

用环境、集合和认证管理请求

环境变量：把 base URL、token 这类值存进环境，请求里用{{变量名}}引用；开发、测试、生产各建一个环境，切环境时不用逐条改请求；
集合：请求和文件夹可以保存进集合，支持嵌套、批量导入导出，方便交接给同事；
认证：Authorization页签提供 Basic、Bearer Token、OAuth 2.0、API Key、JWT 等多种方式，凭证可以放在环境变量里，避免写死在请求中。

举个例子：把 token 挪进环境，联调从测试环境切到预发，只切一次环境就行。

Hoppscotch 在线、自托管与桌面端部署方法

先给选型建议：临时调一个接口，直接用在线版；数据必须留在自己机房，选自托管；想要离线、内网的体验，装桌面版。

在线使用

直接打开官方在线版即可，浏览器里可安装为PWA，支持离线和低资源占用。

自托管（Docker）

仓库自带 docker-compose 配置，后端是完整的 NestJS + Prisma 服务，配套 Postgres 数据库，克隆后一条命令拉起：

git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch docker compose --profile default up -d

部署完成后，应用跑在 3000 端口，自托管管理面板在 3100 端口，后端 API 在 3170 端口；账号体系、团队和工作区、环境同步这些能力也就都有了，不只是一个前端页面。

桌面应用

桌面版支持 Windows、macOS、Linux，加载本地资源，启动快，适合内网离线使用。左上角实例菜单里可以切换云端、自托管和自定义地址的实例，本地开发和内网环境能用同一套集合。

进阶技巧让联调效率再提一档

预请求脚本：每个请求可以挂一段发送前执行的 JavaScript，用来生成时间戳、随机参数、写入环境变量；脚本跑在沙箱里，碰不到浏览器对象，收益是请求永远用最新值。
后置测试：响应回来后跑断言，比如校验状态码为 200、解析字段非空；收益是集合跑一遍就知道哪条挂了，不用肉眼比对。
Zen 模式与键盘流：设置里开启 Zen 模式隐藏所有侧栏，配合 Ctrl/Cmd + K 命令菜单和高密度快捷键；收益是纯键盘发请求，效率接近命令行。
CLI 跑集合：仓库带 CLI，可以在命令行或 CI 里跑集合测试，输出结果报告；收益是把接口回归接进构建流程。