Files
opsxapi/apps/server/internal/docs/content/12-import.md
T
logan dec66db5aa feat: OpsxAPI v1.0 全协议接口工作台
- 六协议调试:HTTP/GraphQL/WebSocket/SSE/Socket.IO/MQTT
- 集合树/多标签/多环境变量/历史记录,localStorage 持久化
- 导入:OpenAPI 2/3/3.1、Postman、Apifox、Apipost、cURL、HAR、
  Insomnia、Hoppscotch、Markdown(自动识别,21 个单测覆盖)
- 导出:OpenAPI 3.0 JSON/YAML、Postman v2.1、Markdown 文档、
  全量备份;单请求生成 cURL/fetch/Python/Go 代码
- Gin 服务:HTTP 代理、NDJSON 流式代理(SSE 透传)、
  WebSocket 隧道(浏览器自定义握手 Header)
- 内置产品官网 /home 与用户文档站 /docs(SSR,随二进制交付)
- lucide 图标体系 + 品牌标识(Logo/favicon),明暗双主题
- 环境变量:彩色徽标切换器、管理弹窗、{{ 自动补全
2026-09-18 00:16:59 +08:00

41 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
顶栏 **导入** 打开导入对话框,支持三种来源:
| 来源 | 说明 |
| --- | --- |
| 粘贴文本 / cURL | 直接粘贴任意受支持格式的内容 |
| 文件导入 | 选择或拖入 `.json` / `.yaml` / `.har` / `.md` / `.txt` |
| URL 导入(Swagger) | 填写 OpenAPI 地址,经本地 Gin 代理拉取,避开 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` | 当前环境变量 |
## 结果确认
导入完成显示汇总:新建集合、接口数量、写入的环境变量与告警(如跳过的文件上传字段)。集合名重复时自动追加序号。