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
当公司合规政策不允许把接口数据传进第三方工具,而你要调试一个内部 API 时怎么办?Hoppscotch 是一款免费的开源 API 测试工具,可以部署在你自己的环境里:REST、GraphQL、WebSocket 都在同一处完成。它是 Postman 与 Insomnia 的开源替代方案,提供网页版、桌面版和 CLI 三种形态。
它是什么:一个可以跑在自己服务器上的 API 客户端
Hoppscotch 的定位是完整的 API 开发生态,而不只是一个发请求的网页。它既可以离线运行、以自托管方式跑在你的内网,也可以直接用官方云服务;请求数据、集合和环境的归属权始终在你手里。
🚀 快速上手:3 步完成第一次接口调试
最快的路径是使用在线版:浏览器打开后,填好请求方法和 URL,点击 Send,状态码、耗时、响应大小与响应体会即时呈现。需要完全掌控数据时,把源码拉下来在本地运行:
git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch偏好原生体验的开发者还有 Windows、macOS、Linux 桌面版,左侧是集合目录树,中间是请求与响应区,右侧可挂团队共享的集合:
🧩 核心能力:协议、认证与环境变量
REST 之外,还能调 GraphQL、WebSocket 与 SSE
左侧导航可直接切换协议。除 REST 编辑器外,还有带 Schema 的 GraphQL 编辑器,以及 WebSocket、Socket.IO、MQTT、SSE 实时通道,认证和变量逻辑在各协议间通用,切换没有学习成本。
七种认证方式,填完凭证就能发请求
Authorization 页签支持 API Key、Basic、Bearer、Digest、Hawk、AWS Signature 与 OAuth 2.0。其中 OAuth 2.0 会自动完成令牌申请与刷新,你不必手动调用令牌接口。认证实现集中在 helpers/auth/ 目录,扩展新方式时从这里入手。
用环境变量替代硬编码的 URL 和密钥
为开发、预发、生产各建一组环境变量,在请求里以{{变量名}}引用。切换环境只需切换激活的变量组,任何请求都不用改。相关逻辑见 newstore/environments.ts。
🧪 进阶玩法
预请求脚本加后置断言,把测试写成自动化
Pre-request Script 页签可以写 JavaScript 动态生成签名或令牌,Tests 页签则用于断言状态码和响应字段。配合 hoppscotch-cli 命令行,整套集合可以进 CI 跑回归,接口测试不再是手点一遍的活。
桌面端一键连接自托管实例
桌面应用左上角可切换数据来源:官方云、自托管实例,或添加你自己维护的实例。对已经部署了后端的公司,桌面版就是它的外设级客户端,数据不出内网:
适合谁用
如果你的公司有数据合规要求,不能把接口数据接入第三方 API 工具,Hoppscotch 的自托管能力几乎是唯一解。个人开发者则看重它免费、多协议、请求自动保存成历史,日常调试足够替代商业客户端。小团队用共享工作区、环境隔离加上 CLI 自动化回归,能形成完整协作闭环。在线、本地、桌面三种形态在不同阶段切换使用,不存在绑定。
先拿在线版调试一个真实接口试试手,满意之后再把整套集合迁到自托管环境,这就是使用 Hoppscotch 成本最低的路径。
【免费下载链接】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),仅供参考