企业官网建设流程全解析

Hoppscotch 免费开源 API 客户端：5 分钟发出第一个请求

【免费下载链接】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 客户端，把环境变量、认证、预请求脚本和断言放在同一个工具里，帮你把这类返工降为零。读完这篇文章，你会用 5 分钟发出第一个请求，并拿到一条从开发到生产的完整工作流。

5 分钟跑通一个请求

1. 输入地址并发送

打开 Hoppscotch 网页端，方法下拉框里选 POST，在地址栏填入接口 URL，点 Send。响应区立刻显示状态码、耗时和体积，JSON 响应体会自动格式化并高亮。

2. 加参数和请求体

切到 GET，Parameters 页签里逐行添加 key-value；POST 则在 Body 页签选择 form-data 或 JSON 等 Content Type 直接输入。响应区底部可切换 JSON、Raw 和 Headers 三种视图，右上角还有复制、下载按钮。

3. 配一次认证并保存

打开 Authorization 页签，选 Bearer Token，粘贴 Token 后再点 Send，状态码从 401 变 200 即配置成功。点 Save 把请求收进集合，之后从右侧面板一键打开重放，不用再手打地址。

能力拆解：按你的测试场景对号入座

多协议请求切换：REST、GraphQL、WebSocket 一个客户端搞定

它解决"一个后端同时暴露多种协议、工具来回切"的问题。界面左上角就是协议切换入口：REST 之外还有 WebSocket、SSE、Socket.IO、MQTT、GraphQL 等选项，切换后整块编辑区换成对应表单。例如调试推送接口时，选 WebSocket 填入 wss 地址即可看到消息进出；选 GraphQL 后填入 endpoint，工具会拉取 schema，点选字段就能拼出查询语句。

认证页签全选项：从 None 到 OAuth 2.0

它解决"每次都在 Headers 里手写凭证"的问题。Authentication 页签提供 None、Basic、Bearer Token、OAuth 2.0、OIDC 等选项，切换后表单自动变化。举例：选 Bearer Token 后粘贴凭证即可；Token 过期时只需改这一个字段，不必翻请求头。

预请求脚本与请求后断言

它解决"每次调用前都要重复算签名、校验状态码"的问题。请求的 Pre-request Script 页签里可写 JavaScript，在请求发出前执行；Tests 页签则接收响应并做断言。例子：脚本里把带时间戳的签名写入变量，URL 中用变量引用，每次请求都自动刷新；响应回来后断言状态码为 200，并把返回的刷新令牌写进环境变量供下次使用。

环境变量切换：同一份请求跑遍所有环境

它解决"改地址、改密钥散落各处"的问题。Variables 面板支持创建多套环境，每套独立存放 baseUrl、token 等变量，顶部环境下拉框一键切换，引用变量的所有请求随之重写。例子：把 URL 写成变量形式后，开发环境指向本地端口，测试环境指向 staging 域名，切换只需一次点击。

跨环境工作流：同一份集合从开发跑到生产

假设你的请求集里所有地址都写成变量引用。开发阶段，选 dev 环境，baseUrl 指向本地 3000 端口，Token 用开发凭证，快速验证新字段；联调通过后切到 test 环境，同一份集合原样回归，差异只体现在环境变量文件里；到了生产演练，把 token 的获取逻辑写进预请求脚本，每次调用自动换发凭证。团队场景下，把集合和环境定义放进共享 workspace，成员各配一份个人凭证即可复用同一套请求。需要跑 CI 时，Hoppscotch CLI 能直接执行同一份集合文件并附带环境文件，断言结果照常输出，请求定义在网页端、桌面端、命令行三处保持一份。

部署与获取：在线、自建、桌面端怎么选

在线版：打开即用，数据在云端

访问官网地址，新开标签页就能发请求，适合快速验证和临时调试；代价是请求与集合同步到云端账号，涉及内部敏感接口时需谨慎。

本地部署：数据留在自己的机器上

若接口涉及敏感数据，建议自建。克隆仓库：

git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch

进入仓库后用 docker compose 的 default 配置启动，它会拉起一体化容器、数据库和迁移服务，本机 3000 端口访问即可。

桌面端：离线可用，还能连自建实例

桌面端为 Windows、macOS、Linux 提供原生应用，离线也能发请求。若已自建服务端，在左上角菜单点 Add an instance，填入自建地址并连接，云版本与自建实例可在下拉菜单里随时切换。

延伸资源

仓库根目录的 README.md 列出了全部功能清单；认证相关组件在 packages/hoppscotch-common/src/components/auth/ 目录；CLI 的用法见 packages/hoppscotch-cli/README.md；桌面端说明见 packages/hoppscotch-desktop/README.md；后端服务代码位于 packages/hoppscotch-backend/ 目录。

建议现在就打开 Hoppscotch，把手头最常调的那组接口导入集合，并在 Variables 里建好 dev、test 两套环境——下一次切换环境时，你会感谢这一步。

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