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

1.7 KiB
Raw Blame History

顶栏 导入 打开导入对话框,支持三种来源:

来源 说明
粘贴文本 / 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 当前环境变量

结果确认

导入完成显示汇总:新建集合、接口数量、写入的环境变量与告警(如跳过的文件上传字段)。集合名重复时自动追加序号。