# API-hub

**Repository Path**: mingwuda/api-hub

## Basic Information

- **Project Name**: API-hub
- **Description**: 一个轻量级本地 API 调试工具，单 HTML 文件即开即用。相比 Postman，它更专注于流式响应和即时渲染场景。
- **Primary Language**: HTML
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# API Client

一个轻量级本地 API 调试工具，单 HTML 文件即开即用。相比 Postman，它更专注于**流式响应**和**即时渲染**场景。

## 为什么选这个而不是 Postman

| 能力 | Postman | 本项目 |
|------|---------|--------|
| 流式响应（SSE / stream+json） | 支持有限，需手动配置 | 原生支持，实时追加原始文本 |
| 响应 Markdown 渲染 | 需插件或手动格式化 | 一键渲染 / 还原，流结束后自动触发 |
| 安装与登录 | 需安装客户端或登录账号 | 单 HTML 文件，浏览器直接打开 |
| 数据存储 | 云端同步，需账号 | 纯本地 localStorage，零上传 |
| API 集合管理 | 需登录云端集合 | 本地文件夹 + API 树，离线可用，支持导入/导出 |
| 多页签 | 支持 | 支持，类似浏览器标签页 |
| curl 导入 | 支持 | 直接粘贴 curl 命令，自动解析填充 |
| 浏览器标签页 | 默认图标 | 自定义 Logo favicon |
| 环境变量 | 支持，但需登录 | 本地多环境变量，`{{变量}}` 占位符，无需登录 |
| 历史搜索 | 支持 | 本地历史搜索过滤，按 URL / 方法 / 状态码 / 响应内容检索 |
| 响应头查看 | 支持 | 请求完成后展示响应头，可展开 / 收起 |
| 请求耗时 | 支持 | 显示总耗时与 TTFB |

## 核心功能

- **流式响应实时输出**：SSE / stream+json 响应逐块追加，自动滚动到底部
- **响应 Markdown 渲染**：点击「渲染」将 JSON / SSE 流渲染为 Markdown；再次点击还原原始文本
- **自动渲染**：流式响应结束后自动触发渲染按钮
- **多 Body 类型**：JSON、Form Data、x-www-form-urlencoded、Raw
- **自定义 Headers / Params**：键值对编辑器，支持增删
- **环境变量**：创建多套环境变量，在 URL、Headers、Body、Params 中使用 `{{变量名}}` 占位符
- **历史记录**：自动保存最近 100 条请求，支持搜索过滤、删除、详情查看、一键回填
- **API 集合**：文件夹 + API 树形管理，保存常用请求，支持导入/导出 JSON
- **多页签**：同时管理多个请求，页签状态持久化
- **curl 粘贴**：直接粘贴 curl 命令，自动解析并填充到当前页签
- **响应头查看**：请求完成后展示响应头，可展开 / 收起
- **请求耗时**：显示总耗时与 TTFB
- **快捷键**：`Ctrl/Cmd + Enter` 发送请求
- **自定义 Logo**：浏览器标签页显示品牌图标

## 使用方法

直接在浏览器中打开 `index.html` 即可使用，无需额外依赖或构建步骤。

## 数据存储

所有历史记录、API 集合和环境变量均保存在浏览器 `localStorage` 中，不会上传到任何服务器。API 集合支持导入/导出为 JSON 文件进行备份和迁移。