官方中文正文为项目官方提供的中文文档（原文转载），本站未作翻译、未改动文字，仅剔除图片与无关章节。

ApiArk

尊重你的隐私、你的内存和你的 Git 工作流的 API 平台。

无需登录。无需云端。无多余负担。

Postman 占用 800 MB 内存。ApiArk 仅需 60 MB。

下载 • 功能特性 • 从 Postman 迁移 • 性能 • 社区 • 开发

为什么选择 ApiArk？

下载

最新版本

# Homebrew (macOS/Linux) — 即将推出
brew install --cask apiark

# Chocolatey (Windows) — 即将推出
choco install apiark

# Snap (Linux) — 即将推出
sudo snap install apiark

# AUR (Arch Linux) — 即将推出
yay -S apiark-bin

git clone https://github.com/berbicanes/apiark.git
cd apiark
pnpm install
pnpm tauri build

从 Postman 迁移

1. 导出你的 Postman 集合（Collection v2.1 JSON）
2. 打开 ApiArk
3. Ctrl+K > "导入集合" > 选择你的文件
4. 完成。你的请求现在是属于你自己的 YAML 文件了。

同样支持从以下工具导入：Insomnia、Bruno、Hoppscotch、OpenAPI 3.x、HAR、cURL。

功能特性

多协议支持 — REST、GraphQL、gRPC、WebSocket、SSE、MQTT、Socket.IO 集于一身。没有任何工具拥有更广泛的协议覆盖。

本地优先存储 — 每个请求都是一个 .yaml 文件。集合就是目录。一切都可以 Git diff。没有私有格式。

深色模式 + 主题 — 深色、浅色、纯黑/OLED 主题，配备 8 种强调色。

TypeScript 脚本 — 带完整类型定义的请求前/后脚本。ark.test()、ark.expect()、ark.env.set()。

集合运行器 — 使用数据驱动测试（CSV/JSON）运行整个集合，可配置迭代次数，输出 JUnit/HTML 报告。

本地 Mock 服务器 — 从你的集合创建模拟 API。Faker.js 数据、延迟模拟、错误注入。无需云端，无使用限制。

定时监控 — 基于 cron 的自动化测试，支持桌面通知和 webhook 告警。在本地运行，而不是在别人的服务器上。

API 文档生成 — 从你的集合生成 HTML + Markdown 文档。

OpenAPI 编辑器 — 使用 Spectral 集成来编辑和校验 OpenAPI 规范。

响应对比 — 在不同运行之间并排对比响应。

代理抓包 — 本地拦截式 HTTP/HTTPS 代理，用于流量检查和重放。

AI 助手 — 自然语言转请求、自动生成测试、兼容 OpenAI 的 API。

插件系统 — 使用 JavaScript 或 WASM 插件扩展 ApiArk。

导入一切 — Postman、Insomnia、Bruno、Hoppscotch、OpenAPI、HAR、cURL。一键迁移。

性能

基于 Tauri v2 构建（Rust 后端 + 原生 OS webview），而非 Electron。

数据格式

你的数据是纯 YAML。无供应商锁定。无私有编码。

# users/create-user.yaml
name: Create User
method: POST
url: "{{baseUrl}}/api/users"

headers:
  Content-Type: application/json

auth:
  type: bearer
  token: "{{adminToken}}"

body:
  type: json
  content: |
    {
      "name": "{{userName}}",
      "email": "{{userEmail}}"
    }

assert:
  status: 201
  body.id: { type: string }
  responseTime: { lt: 2000 }

tests: |
  ark.test("should return created user", () => {
    const body = ark.response.json();
    ark.expect(body).to.have.property("id");
  });

CLI

# 运行一个集合
apiark run ./my-collection --env production

# 使用数据驱动测试
apiark run ./my-collection --data users.csv --reporter junit

# 导入 Postman 集合
apiark import postman-export.json

无锁定承诺

如果你决定离开 ApiArk，你的数据会随你一起走。每个文件都是标准格式。每个数据库都是开放的。我们永远不会让迁移变得困难。

社区

• Discord — 聊天、提问、分享反馈
• Twitter / X — 更新与公告
• GitHub Discussions — 创意、问答、项目展示
• GitHub Issues — Bug 报告和功能请求

翻译

ApiArk 界面通过 react-i18next 支持国际化。目前提供英语版本。

帮助我们将 ApiArk 翻译成你的语言！请查看 locales/ 目录并提交 PR。

开发

# 安装依赖
pnpm install

# 以开发模式运行
pnpm tauri dev

# TypeScript 类型检查
pnpm -C apps/desktop exec tsc --noEmit

# 构建生产版本
pnpm tauri build

项目结构

apiark/
├── apps/
│   ├── desktop/           # Tauri v2 桌面应用
│   │   ├── src/           # React 前端
│   │   └── src-tauri/     # Rust 后端
│   ├── cli/               # CLI 工具 (Rust)
│   ├── mcp-server/        # 面向 AI 编辑器的 MCP 服务器
│   └── vscode-extension/  # VS Code 扩展
├── packages/
│   ├── types/             # 共享 TypeScript 类型
│   └── importer/          # 集合导入器
└── docs/                  # Documentation

技术栈

前端： React 19、TypeScript、Vite 6、Zustand、Tailwind CSS 4、Monaco Editor、Radix UI

后端： Rust、Tauri v2、reqwest、tokio、tonic (gRPC)、axum (Mock 服务器)、deno_core (脚本引擎)

贡献

Contributions are welcome! Check out the GitHub Issues for open tasks and feature requests.

许可证

MIT

_{如果 ApiArk 改善了你的工作流，请给它一个 Star。这能帮助更多人发现这个项目。}