logan
ec9a7b8695
- 删「打印/导出 PDF」按钮与「是否有帮助」反馈组件（静态站无后端，纯摆设）及未使用 SVG 图标 - 文档去 Tauri/Gin 等实现层名词（本地代理/隧道等用户语义保留） - 5 页 markdown 首行 H1 与页面标题去重 - homepage dist 同步重建
41 lines
1.7 KiB
Markdown
41 lines
1.7 KiB
Markdown
顶栏 **导入** 打开导入对话框，支持三种来源：
|
||
|
||
| 来源 | 说明 |
|
||
| --- | --- |
|
||
| 粘贴文本 / cURL | 直接粘贴任意受支持格式的内容 |
|
||
| 文件导入 | 选择或拖入 `.json` / `.yaml` / `.har` / `.md` / `.txt` |
|
||
| URL 导入（Swagger） | 填写 OpenAPI 地址，经本地代理拉取，避开 CORS |
|
||
|
||
格式**自动识别**，也可手动指定。
|
||
|
||
## 支持格式
|
||
|
||
| 格式 | 细节 |
|
||
| --- | --- |
|
||
| OpenAPI 3.0 / 3.1、Swagger 2.0 | JSON 或 YAML；Apifox 导出的 OpenAPI 同样适用 |
|
||
| Postman Collection | v2.0 / v2.1，含鉴权、变量、GraphQL body |
|
||
| Apipost 项目 | `api_collection` 格式（宽容解析） |
|
||
| cURL | 引号、续行、`-d` / `-F` / `-u` / `--data-urlencode`、cookie、代理等参数 |
|
||
| HAR | 按域名分组、相同请求去重 |
|
||
| Insomnia | 导出文件 v3 / v4，含 workspace / group 层级 |
|
||
| Hoppscotch | 集合 JSON（数组或单对象） |
|
||
| Markdown | 提取文中的 ```curl 代码块 |
|
||
| OpsxAPI 备份 | 全量集合 + 环境，用于迁移恢复 |
|
||
|
||
YApi、Apidoc、Apizza、Eolink 请先在原平台导出为 **OpenAPI 或 Postman** 格式，再导入本工具。
|
||
|
||
## 导入时自动完成
|
||
|
||
| 原始内容 | 转换结果 |
|
||
| --- | --- |
|
||
| OpenAPI `tags` | 目录分组 |
|
||
| 路径参数 `/pets/{petId}` | `{{petId}}` 变量 + 环境示例值 |
|
||
| `servers` 地址 | 当前环境 `baseUrl` 变量 |
|
||
| requestBody schema | JSON 示例请求体 |
|
||
| securitySchemes | Bearer / Basic / API Key 鉴权配置 |
|
||
| Postman `variable` | 当前环境变量 |
|
||
|
||
## 结果确认
|
||
|
||
导入完成显示汇总：新建集合、接口数量、写入的环境变量与告警（如跳过的文件上传字段）。集合名重复时自动追加序号。
|