Hoppscotch API 测试工具：3 分钟装好，发出第一个带 Token 的 POST 请求

Hoppscotch API 测试工具3 分钟装好发出第一个带 Token 的 POST 请求【免费下载链接】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/hoppscotchHoppscotch 是一个开源的 API 开发平台定位是 Postman 和 Insomnia 的免费替代品。它支持 REST、GraphQL、WebSocket、MQTT 四种协议可以跑在网页、桌面和 CLI 三种形态里也能整套部署到自己的服务器。适合想把 API 调试、测试和团队共享收进同一个工具的开发者。读完这篇文章你会在本机跑起 Web 版界面发出第一个带 Bearer Token 认证的 POST 请求并配上状态码断言。一、它凭什么不一样 开源免费Postman 平替无付费墙 可离线、可自建服务器数据留在自己手里 REST / GraphQL / WebSocket / MQTТ 一套界面全收️ Web、桌面、CLI 三端共用同一套集合⚙️ 集合和断言可以直接跑进 CI 流水线二、三分钟跑起来装东西之前先说清三个前置Node.js 20 或更高后面 CLI 部分要 22、装好 pnpm可以理解为装了涡轮增压的 npm多包工作区装得又快又齐、手边有一个终端。先在终端里克隆仓库git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch接着安装全部依赖pnpm install预期你会看到packages/hoppscotch-common和packages/hoppscotch-selfhost-web等子包依次完成末尾出现Done in xx s。若报 pnpm 命令不存在先用corepack enable激活它。Web 端本地跑起来咱们最推荐先跑 Web 端一条命令就能开起来pnpm -F hoppscotch/selfhost-web dev预期你会看到Local: http://localhost:3000/。用浏览器打开这个地址看到请求面板、上方一排协议标签REST、GraphQL、WebSocket……就算成功。若浏览器打不开跳第五节第 1 条。桌面端顺手也开一个桌面端基于 Tauri一套用 Rust 写原生应用窗口的框架可以理解为浏览器套了个系统壳需要本机先装好 Rust 工具链。在仓库根目录执行pnpm -F hoppscotch-desktop dev:full预期你会看到 Vite 就绪日志随后弹出一个原生桌面窗口界面和 Web 端一致但请求由本机直发天然不受浏览器跨域限制。若报cargo: command not found跳第五节第 3 条。三、第一个真实任务发一个带 Bearer Token 的 POST 并断言状态码跑通界面之后咱们就干一件最典型的 API 测试的事用 Bearer Token 发 POST再断言返回 200。第一步做什么目标是向https://httpbin.org/post发一个带认证的 POST请求体是一段 JSON响应状态码不是 200 就算测试失败。第二步在哪配打开网页左侧 Environments 面板里 New Environment建一个dev环境加两个变量base_url填https://httpbin.orgtoken填任意测试字符串。然后回到请求区方法选 POST地址栏填${base_url}/post在 Body 选 JSON 并写入一个小对象比如{hello:hoppscotch}。再点请求行旁边的 Auth 标签选 Bearer TokenToken 一栏填{{token}}——变量会被环境自动替换令牌本身不落进集合文件。最后点 Post-response Script 标签写一行断言if (response.status.code ! 200) { throw new Error(expect 200); }第三步怎么确认成功点 Send。右侧状态栏出现绿色的200 OK底部脚本区显示运行通过请求体在 httpbin 的回显里能看到这就是断言生效了。若状态码不是 200先检查 URL 拼写若脚本区报令牌错误说明变量没替换成功回去看 Auth 一栏是不是少了{{}}。四、按需解锁如果你需要把已有的 Postman 或 Insomnia 请求搬进来 → 打开左侧 Collections 面板点右上角导入图标把导出文件直接拖进去整个集合树原样落地。如果你需要团队共享和账号体系 → 打开仓库根目录的docker-compose.yml执行docker compose up -d把后端、数据库和 Web 整套自建服务拉起来再把桌面端的连接地址指向你的服务即可用自建账号协作。如果你需要在 CI 里自动跑接口测试 → 打开packages/hoppscotch-cli/构建后用它导出的hopp命令执行hopp test my-collection.json -e env.json --reporter-junit预期你会看到逐条请求的通过/失败清单末尾生成 JUnit 报告可以直接喂给任何 CI 面板。CLI 要求 Node 22 或更高低于这个版本会直接报unsupported处理办法见第五节第 4 条。五、踩坑速查现象dev 启动报EADDRINUSE→ 大概率原因3000 端口被别的进程占着 → 一句话修复lsof -i :3000找到它改掉再启动。现象pnpm install后部分包启动报模块找不到 → 大概率原因跳过了依赖后装步骤 → 一句话修复回到仓库根目录重新跑一次pnpm install。现象桌面端启动报cargo: command not found→ 大概率原因没装 Rust 工具链 → 一句话修复按 Rust 官方安装器装好后重跑pnpm -F hoppscotch-desktop dev:full。现象hopp命令报unsupported→ 大概率原因Node 版本低于 CLI 要求的 22 → 一句话修复用 nvm 升到 22 再重新构建 CLI 包。跑通第一个请求你的 API 测试工具就算正式到手了。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考