企业官网建设流程全解析

3 步发出第一个 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

联调接口时最烦的场景：改一个参数要翻回文档，换一套 Token 又要钻进配置里找。Hoppscotch 是开源免费的 API 测试工具，在一个界面里发 REST、GraphQL、WebSocket、SSE 请求，内置环境变量、请求集合与五种认证方式，是对标 Postman、Insomnia 的开源替代。下面按「接进来 → 管起来 → 跑起来 → 用起来」的顺序走一遍，读完就能自己上手。

接进来：三招把第一个请求发出去

这个 API 测试工具打开后没有引导页，中间就是请求编辑区，三步发出第一个请求：

1. 选方法。GET、POST、PUT、DELETE 等常规方法都支持，也可以直接输入 LIST 这类自定义方法；
2. 在 URL 栏填接口地址，需要时展开 Query 参数、Header、Body 三个页签补充内容；
3. 点 Send（快捷键 Ctrl/Cmd + Enter），下方立刻出现状态码、耗时、响应头和格式化后的响应体。

几个顺手的能力：

• Body 按 Content Type 切换 JSON、FormData、表单编码，键值对与 RAW 两种输入随时切；
• 响应区支持复制、下载，HTML、JSON、XML、图片都能直接预览；
• 左侧入口可切到 WebSocket、SSE、Socket.IO、MQTT，长连接和服务器推送流不用写轮询代码；
• 切到 GraphQL 页签做 GraphQL 测试：填好 endpoint 自动拉取 schema，带文档面板，查完直接看结果；
• 发出去的请求自动进历史记录，随时回看重发。

REST 请求界面的实现在 packages/hoppscotch-common/src/components/http/

管起来：变量、集合、认证各归其位

环境切换不用改请求

把 base URL、token 这类值存进环境，请求里用{{变量名}}引用。开发、测试、生产各建一个环境，切环境时整组值一起换，不用逐条翻请求。

五种认证方式按需选

Authorization 页签提供 None、Basic、Bearer Token、OAuth 2.0、OIDC（含 PKCE）五种方式。凭证放进环境而不是写死在单个请求里，换人接手也不用到处找。

集合支持导入导出

请求和文件夹存进集合，支持嵌套。整包导入导出为文件或 GitHub gist，交接同事直接用；单个请求可导出为 10 多种语言的代码片段，也支持粘贴 cURL 命令直接导入。

跑起来：在线、自托管、桌面端三条路

在线版直接开

浏览器打开官方在线版即可，还能安装为 PWA，支持离线、低内存占用。临时调一个接口、不想装东西时走这条。

自托管一条命令拉起

数据要留在自己机房时，仓库自带 docker-compose 配置，Hoppscotch 自托管只需克隆后执行：

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

注意它走的是仓库自带的完整后端（Prisma + NestJS），含团队、环境同步等能力，需要数据库等配套组件，不是一个静态前端页面。

桌面端连接自托管实例

桌面版支持 Windows、macOS、Linux，把 API 测试工具装进本地，内网离线也能用。安装后在左上角实例菜单选 "Add an instance"，填入自托管地址，云端与本地实例在同一入口切换。

桌面版请求编辑与 JSON 响应展示效果见下图，实现代码在 packages/hoppscotch-desktop/

用起来：脚本、断言与纯键盘流

预请求脚本与响应断言

每个请求可挂一段发送前执行的 JavaScript：生成时间戳、补随机参数、写入环境变量都行，脚本跑在沙箱里，碰不到浏览器对象。响应回来后再跑断言，校验状态码是否为 200、检查响应字段是否符合预期。

Zen 模式与键盘流

设置里开启 Zen 模式，隐藏所有侧栏，只剩请求编辑区。配合 Ctrl/Cmd + K 命令菜单和成套快捷键，纯键盘发请求，效率接近命令行。

CORS 报错开代理

浏览器里发请求被跨域拦下时，去设置里开启代理模式。官方提供代理，也可以填自己的代理地址；顺带解决非 HTTPS 接口被浏览器拦截的问题。

没登录数据存在哪

请求、历史、集合默认存在当前浏览器的本地会话存储，不登录也不丢。但换设备、清缓存后拿不回来，需要跨端同步就登录账号，支持 GitHub、Google、Microsoft 与邮箱登录，登录后数据多端实时同步。

团队协作按角色分权限

登录后可建团队和工作区，共享集合与环境，成员权限按角色控制。个人项目和团队项目用工作区隔离，互不干扰。

一个免费开源的 API 测试工具就能覆盖发请求、管变量、换环境、交接给同事这几件事，想改源码或私有化部署都没有门槛。 相关资源：README.md、CONTRIBUTING.md

【免费下载链接】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