ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

Hoppscotch 从零上手:一次跑通你的第一个 API 请求

Hoppscotch 从零上手:一次跑通你的第一个 API 请求 Hoppscotch 从零上手一次跑通你的第一个 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/hoppscotchHoppscotch 是一个开源的 API 请求工具也是 Postman 的免费替代在浏览器里发 REST、GraphQL、WebSocket 请求还能把请求整理成集合。本教程带你把它装到本地从空白终端走到发出第一个真实 API 请求。为什么可以试试用 Hoppscotch 替代 Postman先用 Postman 的你常见的不满集中在两点免费版功能限制越来越多数据默认存在对方云端。Hoppscotch 把这两点反过来了——它完全开源免费代码就放在你手上想自托管就自托管请求数据可以只留在本机。维度HoppscotchPostman费用完全开源免费无付费档免费档 付费档运行方式网页、桌面端、CLI、PWA 都有以桌面客户端为主数据存储本地或自托管后端默认官方云协议覆盖REST、GraphQL、WebSocket、Socket.IO、MQTT、SSEREST 为主其余部分需要额外配置如果你只需要发请求、看响应、存下来Hoppscotch 是更轻的选择如果重度依赖它的企业级流程可以两边并行。先把环境准备好Hoppscotch 是 pnpm 管理的多包仓库所以只需备齐三样东西Node.js 18 或更高版本官方开发容器用的就是 Node 18更新版本没问题pnpm仓库要求 10.x装 Node 后可用corepack enable自动带出对应版本Git用来拉代码装完后在终端跑一下版本检查node -v pnpm -v成功标志终端输出两个版本号Node 不低于 18.xpnpm 有正常输出。到这一步后面所有命令都能直接用。10 分钟在本地跑起 Hoppscotch 网页版这是最省事的路径不编译桌面端桌面端需要额外的 Rust/Tauri 环境日常使用直接装官方发布的安装包或打开官网即可而是把 Web 版跑在你自己的机器上。第一步克隆仓库到本地git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch第二步初始化配置文件。仓库根目录的.env.example是配置模板本地开发不需要改动复制一份作为.env即可cp .env.example .env第三步安装依赖pnpm install这一步会花几分钟因为仓库里有十几个工作区还包含 canvas、argon2 这类需要编译原生模块的依赖。成功标志终端没有红色报错最后自动跑了一次 GraphQL 代码生成看到 gql-codegen 相关输出说明依赖装好了。第四步启动开发服务器pnpm dev成功标志终端出现 Vite 的 ready 提示浏览器打开http://localhost:3000能看到 Hoppscotch 的主界面——顶部是请求栏左侧是集合和标签页这就是它的标准工作台。如果你的设备也装了 Hoppscotch 桌面客户端界面长得差不多只是多了一层本地存储离线也能用。发出第一个 API 请求并把它存下来现在界面已经在了做一次完整闭环发请求、看结果、存下来。在顶部 URL 输入框里填https://httpbin.org/get请求方式保持默认的 GET。按回车或点 Send。下方会立刻返回结果。检查两处状态码是200响应体是一段 JSON里面包含你发起请求时的 IP 和 User-Agent。看到这两样说明请求真的从你机器发出去、绕了一圈回来了。把这次请求留下来点响应区右侧的Save它会弹出一个保存面板起个名字、选个集合没有就先建一个叫First的集合。保存成功后左侧集合树里会出现这条请求以后双击就能重发。顺手再试一个更实用的动作如果你手上有从同事那里拿到的 curl 命令点右上角的Import curl把整段贴进去方法、URL、Header、Body 会自动拆好填进界面不用手工翻译。想更进一步别的协议左侧标签栏切到 GraphQL填一个带 schema 的端点后会自动拉取字段可以点选拼查询WebSocket、MQTT、Socket.IO、SSE 也都是同样的切标签方式。团队协作仓库自带后端用docker compose --profile default up就能把前后端和数据库一起拉起来Web 应用仍然在 3000 端口这时注册账号后集合、环境、历史就都存在你自己的服务器上了。命令行仓库里的packages/hoppscotch-cli/是一个独立 CLI命令名叫hopp把集合变成脚本化测试就跑在那里。新手最容易卡住的 3 个情况npm install 直接报错现象还没装完就跳出 Only pnpm is allowed 之类的错误。 原因仓库的 preinstall 钩子强制要求用 pnpm防止包管理不一致。 解法别用 npm/yarn统一pnpm install没有 pnpm 就先corepack enable。3000 端口被占用现象pnpm dev后浏览器打开 3000 端口看到的不是 Hoppscotch 而是别的东西。 原因本机已有其他服务占了 3000 端口。 解法lsof -i :3000找到占用进程关掉它或修改packages/hoppscotch-selfhost-web/里 Vite 配置的端口。依赖安装特别慢或中途失败现象装了几十分钟最后卡在某个原生模块上。 原因工作区多、原生依赖重加上网络波动。 解法先pnpm store prune清理缓存再pnpm install重试如果反复失败优先检查 Node 版本是否达到 18。走到这里你已经完成了从克隆到发出第一个请求的全过程Hoppscotch 的日常用法基本就是发请求—存集合—换环境这个循环。下一步建议把现有的 Postman 或 Insomnia 集合直接导入进来右上角有导入入口它会自动转成 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),仅供参考
返回列表