API调试工具 (TinyApi)

一个基于Wails + Svelte构建的现代化API调试工具，提供直观的界面和强大的功能来测试和调试HTTP API。

功能特性

🚀 核心功能

• HTTP方法支持: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS
• 请求配置: URL, Headers, Query Parameters, Request Body
• 响应展示: 状态码, 响应头, 响应体, 响应时间
• 环境变量管理: 支持多环境配置和变量插值
• 历史记录: 自动保存请求历史，支持快速重放
• 数据导入导出: JSON格式的请求配置导出和导入

🎨 用户界面

• 现代化设计: 基于Svelte的响应式UI
• 暗色/亮色主题: 支持系统主题切换
• 代码高亮: JSON响应体语法高亮
• 实时预览: 请求URL和参数的实时预览
• 分栏布局: 请求配置和响应展示分栏显示

🔧 技术特性

• 前端框架: Svelte + Vite
• HTTP客户端: Axios
• 图标库: Lucide Svelte
• 构建工具: Wails v2.10.2
• 跨平台: Windows原生应用

快速开始

安装依赖

cd frontend
npm install

开发模式运行

wails dev

构建应用

wails build

运行应用

./build/bin/TinyApi.exe

使用说明

1. 基本请求

1. 选择HTTP方法 (GET, POST, PUT, DELETE等)
2. 输入目标URL
3. 添加必要的请求头和查询参数
4. 对于POST/PUT请求，在Body标签页输入请求体
5. 点击"发送请求"按钮

2. 环境变量管理

1. 点击右上角的环境管理图标
2. 创建新的环境或选择现有环境
3. 添加环境变量 (如: baseUrl, apiKey, token等)
4. 在URL中使用 {{variable}} 语法进行变量插值

3. 历史记录

• 所有发送的请求会自动保存到历史记录
• 点击历史记录中的条目可以快速重放请求
• 支持清除历史记录

4. 数据持久化

• 应用关闭后自动保存当前配置
• 支持导出/导入请求配置为JSON文件
• 环境变量配置自动保存

界面布局

顶部工具栏

• HTTP方法选择器
• URL输入框
• 发送请求按钮
• 环境管理按钮

请求配置区域 (标签页)

1. Headers: 请求头管理
2. Params: 查询参数管理
3. Body: 请求体编辑 (支持JSON, form-data等)
4. Auth: 认证配置 (Basic Auth, Bearer Token)

响应展示区域

• 状态信息: 状态码, 响应时间, 数据大小
• 响应头: 以键值对形式展示
• 响应体: 语法高亮的JSON预览

侧边栏

• 历史记录: 最近的请求列表
• 环境变量: 当前环境变量列表

技术栈

前端

• Svelte: 组件化框架
• Vite: 构建工具
• Axios: HTTP客户端
• Lucide Svelte: 图标库
• CSS3: 现代化样式

后端

• Go: 主要编程语言
• Wails: 桌面应用框架

开发工具

• Node.js: JavaScript运行时
• npm: 包管理器
• Go 1.25+: Go语言环境

开发指南

项目结构

ApiDebugger/
├── frontend/           # 前端代码
│   ├── src/
│   │   ├── components/ # Svelte组件
│   │   ├── assets/     # 静态资源
│   │   └── App.svelte  # 主应用组件
│   └── package.json    # 前端依赖
├── build/              # 构建输出
│   └── bin/           # 可执行文件
├── main.go            # Go主程序
└── go.mod             # Go模块配置

添加新功能

1. 在 frontend/src/components/ 创建新的Svelte组件
2. 在主应用 App.svelte 中引入组件
3. 如果需要Go后端支持，在 main.go 中添加相应方法
4. 通过Wails绑定机制连接前后端

自定义主题

修改 frontend/src/App.svelte 中的CSS变量来定制主题颜色：

:root {
  --primary-color: #007acc;
  --background-color: #f8f9fa;
  --text-color: #333;
}

故障排除

常见问题

1. 构建失败: 确保Node.js和Go环境正确安装
2. 依赖问题: 运行 npm install 和 go mod tidy
3. 运行时错误: 检查控制台输出获取详细错误信息

获取帮助

• 查看Wails文档: https://wails.io/docs
• 检查控制台日志获取详细错误信息
• 确保所有依赖包版本兼容

贡献指南

欢迎提交Issue和Pull Request来改进这个项目！

许可证

MIT License - 详见LICENSE文件