Yaak API客户端快速上手指南：5 种协议一网打尽

Yaak API客户端快速上手指南：5 种协议一网打尽

【免费下载链接】yaakThe most intuitive desktop API client. Organize and execute REST, GraphQL, WebSockets, Server Sent Events, and gRPC 🦬项目地址: https://gitcode.com/GitHub_Trending/ya/yaak

Yaak API客户端是一款开源桌面工具，在同一个窗口里发送和管理 REST、GraphQL、WebSocket、SSE、gRPC 五种协议的请求。Tauri + Rust + React 构建，数据本地优先、无遥测，适合从 Postman 换环境、或刚接触 API 调试的你。

🚀 3 步跑通 Yaak API客户端本地开发环境

仓库是 Node.js 与 Rust 混合的 monorepo，按 DEVELOPMENT.md 操作，核心就这几条命令：

git clone https://gitcode.com/GitHub_Trending/ya/yaak cd yaak

npm install npm run bootstrap npm start

• 前置依赖：Node.js v24+、Rust 工具链、Vite+ 的vpCLI
• bootstrap会自动安装 wasm-pack、构建全部 workspace、vendor 插件与 protoc，别跳过
• Rust 首次编译需要几分钟，等窗口弹出即可

赶时间也可以只在浏览器里跑前端，数据落在 IndexedDB，无需 Tauri 宿主：

YAAK_TARGET=web npm run dev --workspace @yaakapp/yaak-client

后面做 gRPC 调试时会用到这套构建产物：gRPC 客户端、proto 编解码与反射实现的源码都在 crates/yaak-grpc/。

📥 从 Postman 和 OpenAPI 迁移到 Yaak 的最短路径

老集合不用手工搬。Yaak 内置了一整套导入器插件，源码在 plugins/ 目录，照着名字找就行：

• importer-postman：Postman 集合，目录结构映射为嵌套文件夹
• importer-postman-environment：Postman 环境文件
• importer-openapi：OpenAPI / Swagger 规范
• importer-curl：粘贴一条 curl 命令直接变成请求
• importer-insomnia、importer-yaak：Insomnia 与 Yaak 自身导出

操作路径：在应用里打开 Import 入口，选对应格式，拖入文件即可。迁移完建议先做一件事：把写死的 base URL 换成模板标签，这一节先卖个关子，往下看。

🔐 认证配置实操：从 Bearer 到 OAuth 2.0 全流程

请求面板有独立的认证标签页，常用方案都有现成插件：

• auth-bearer/auth-basic：填 Token 或用户名密码
• auth-jwt：选算法（如 HS256），填 Secret 或 Private Key，再写 Payload JSON，Token 自动签发并挂到请求头
• auth-oauth2：Authorization Code 流程，带 PKCE 开关
• auth-aws、auth-ntlm、auth-apikey：应对 AWS 签名等特殊情况

敏感值不必明文存：Yaak 支持加密保存密钥，或把 Secret 放进操作系统 Keychain。团队协作时分工很清楚——密钥走加密通道，环境变量负责在 dev / staging / prod 之间切换，两边互不干扰。

🔍 让 Yaak API客户端更快：curl 导出与 JSONPath 过滤

把任意请求复制成 curl

选中请求右键，Copy as Curl（插件action-copy-curl）即可得到可直接执行的命令行版本，方便丢进 CI 或让同事复现：

curl -X POST 'https://api.example.com/users' \ -H 'Authorization: Bearer TOKEN' \ -d '{"name": "John"}'

模板标签生成动态值

URL、Header、Body 里都能写${{uuid.v4()}}这样的模板标签，发送前实时渲染。template-function-*系列插件提供了 uuid、timestamp、encode、hash、json、fs 等函数，随机值和时间戳再也不用手敲——上一节说的 base URL 改造，就是在这里把固定地址换成可切换的环境变量加模板标签。

用 JSONPath 秒查大响应

响应 JSON 上千行？在响应面板底部的过滤框输入$..name，filter-jsonpath插件立刻抽出所有匹配项；XML 响应则交给filter-xpath：

插件生态：从认证到主题都能扩展

插件是 Yaak 的核心扩展机制，plugins/目录就是现成教材。几个代表性的：

• auth-oauth2：完整 OAuth 2.0 授权码流程
• filter-xpath：XML 响应过滤
• template-function-timestamp：动态时间戳
• themes-yaak：内置主题包

从装环境到导出 curl，Yaak API客户端把五类协议压进一个本地优先的窗口里，没有云账号，也没有遥测。打开终端，跑完npm run bootstrap，你离第一个发出去的请求只差三分钟。

【免费下载链接】yaakThe most intuitive desktop API client. Organize and execute REST, GraphQL, WebSockets, Server Sent Events, and gRPC 🦬项目地址: https://gitcode.com/GitHub_Trending/ya/yaak