Files
opsxapi/homepage/dist/docs/import/index.html
T
logan ec9a7b8695 文档站面向用户清理:删摆设组件 + 去实现名词 + 标题去重
- 删「打印/导出 PDF」按钮与「是否有帮助」反馈组件(静态站无后端,纯摆设)及未使用 SVG 图标
- 文档去 Tauri/Gin 等实现层名词(本地代理/隧道等用户语义保留)
- 5 页 markdown 首行 H1 与页面标题去重
- homepage dist 同步重建
2026-10-16 13:20:46 +08:00

257 lines
8.9 KiB
HTML
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.
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>数据导入 · OpsxAPI 文档</title>
<meta name="description" content="OpsxAPI 接口工作台用户文档 — HTTP、GraphQL、WebSocket、SSE、Socket.IO、MQTT 一站式调试,支持 OpenAPI/Postman/cURL 等格式导入导出。">
<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='7' fill='%232563eb'/%3E%3Ctext x='16' y='22' font-size='18' font-weight='bold' fill='%23fff' text-anchor='middle' font-family='sans-serif'%3EO%3C/text%3E%3C/svg%3E">
<link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2064%2064%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%2264%22%20y2%3D%2264%22%20gradientUnits%3D%22userSpaceOnUse%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22%232563EB%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22%2306B6D4%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%2264%22%20height%3D%2264%22%20rx%3D%2214%22%20fill%3D%22url%28%23g%29%22%2F%3E%3Cg%20stroke%3D%22%23fff%22%20stroke-width%3D%225%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%20fill%3D%22none%22%3E%3Cpath%20d%3D%22M17%2025h26%22%2F%3E%3Cpath%20d%3D%22M37%2019l6%206-6%206%22%2F%3E%3Cpath%20d%3D%22M47%2039H21%22%2F%3E%3Cpath%20d%3D%22M27%2033l-6%206%206%206%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E">
<link rel="stylesheet" href="/docs/assets/docs.css">
</head>
<body>
<svg xmlns="http://www.w3.org/2000/svg" style="display:none" aria-hidden="true">
<symbol id="i-menu" viewBox="0 0 24 24"><path d="M4 5h16" /> <path d="M4 12h16" /> <path d="M4 19h16" /></symbol>
<symbol id="i-search" viewBox="0 0 24 24"><path d="m21 21-4.34-4.34" /> <circle cx="11" cy="11" r="8" /></symbol>
</svg>
<header class="topbar">
<div class="topbar-inner">
<button class="menu-btn" id="menu-btn" aria-label="打开导航"><svg class="i"><use href="#i-menu"/></svg></button>
<a class="brand" href="/docs">
<span class="brand-logo"><svg width="28" height="28" viewBox="0 0 64 64" aria-label="OpsxAPI"><defs><linearGradient id="lg-docs" x1="0" y1="0" x2="64" y2="64" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#2563EB"/><stop offset="1" stop-color="#06B6D4"/></linearGradient></defs><rect width="64" height="64" rx="14" fill="url(#lg-docs)"/><g stroke="#fff" stroke-width="5" stroke-linecap="round" stroke-linejoin="round" fill="none"><path d="M17 25h26"/><path d="M37 19l6 6-6 6"/><path d="M47 39H21"/><path d="M27 33l-6 6 6 6"/></g></svg></span>
<span class="brand-name">OpsxAPI <em>文档</em></span>
</a>
<span class="ver-badge">v1.0</span>
<div class="search">
<input id="search-input" type="search" placeholder="搜索文档…" autocomplete="off" spellcheck="false">
<div class="search-panel" id="search-panel" hidden></div>
</div>
<nav class="top-links">
<a href="/home">官网</a>
<a href="/" target="_blank" rel="noopener">打开工作台 ↗</a>
</nav>
</div>
</header>
<div class="layout" id="layout">
<aside class="sidebar" id="sidebar">
<div class="nav-group">
<div class="nav-group-title">开始使用</div>
<a class="nav-link" href="/docs/intro">产品介绍</a>
<a class="nav-link" href="/docs/quickstart">快速开始</a>
<a class="nav-link" href="/docs/interface">界面导览</a>
</div>
<div class="nav-group">
<div class="nav-group-title">请求调试</div>
<a class="nav-link" href="/docs/http">发送 HTTP 请求</a>
<a class="nav-link" href="/docs/auth">接口鉴权</a>
<a class="nav-link" href="/docs/env">环境与变量</a>
<a class="nav-link" href="/docs/graphql">GraphQL</a>
<a class="nav-link" href="/docs/websocket">WebSocket</a>
<a class="nav-link" href="/docs/sse">SSE 事件流</a>
<a class="nav-link" href="/docs/socketio">Socket.IO</a>
<a class="nav-link" href="/docs/mqtt">MQTT</a>
</div>
<div class="nav-group">
<div class="nav-group-title">数据管理</div>
<a class="nav-link active" href="/docs/import">数据导入</a>
<a class="nav-link" href="/docs/export">导出与代码生成</a>
<a class="nav-link" href="/docs/mock">Mock 数据</a>
<a class="nav-link" href="/docs/manage">集合与历史</a>
</div>
<div class="nav-group">
<div class="nav-group-title">自动化测试与 AI</div>
<a class="nav-link" href="/docs/testing">自动化测试</a>
<a class="nav-link" href="/docs/ai">AI 助手</a>
</div>
<div class="nav-group">
<div class="nav-group-title">账号与团队</div>
<a class="nav-link" href="/docs/account">账号与团队</a>
</div>
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
</div>
<div class="sidebar-foot">© 2026 OpsxAPI · 本地优先的接口工作台</div>
</aside>
<main class="content">
<div class="breadcrumb">文档 <span>/</span> 数据管理 <span>/</span> 数据导入</div>
<h1 class="page-title">数据导入</h1>
<div class="page-meta">更新于 2026-09-17</div>
<article class="md">
<p>顶栏 <strong>导入</strong> 打开导入对话框,支持三种来源:</p>
<table>
<thead>
<tr>
<th>来源</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>粘贴文本 / cURL</td>
<td>直接粘贴任意受支持格式的内容</td>
</tr>
<tr>
<td>文件导入</td>
<td>选择或拖入 <code>.json</code> / <code>.yaml</code> / <code>.har</code> / <code>.md</code> / <code>.txt</code></td>
</tr>
<tr>
<td>URL 导入(Swagger)</td>
<td>填写 OpenAPI 地址,经本地代理拉取,避开 CORS</td>
</tr>
</tbody>
</table>
<p>格式<strong>自动识别</strong>,也可手动指定。</p>
<h2 id="sec-1">支持格式</h2>
<table>
<thead>
<tr>
<th>格式</th>
<th>细节</th>
</tr>
</thead>
<tbody>
<tr>
<td>OpenAPI 3.0 / 3.1、Swagger 2.0</td>
<td>JSON 或 YAML;Apifox 导出的 OpenAPI 同样适用</td>
</tr>
<tr>
<td>Postman Collection</td>
<td>v2.0 / v2.1,含鉴权、变量、GraphQL body</td>
</tr>
<tr>
<td>Apipost 项目</td>
<td><code>api_collection</code> 格式(宽容解析)</td>
</tr>
<tr>
<td>cURL</td>
<td>引号、续行、<code>-d</code> / <code>-F</code> / <code>-u</code> / <code>--data-urlencode</code>、cookie、代理等参数</td>
</tr>
<tr>
<td>HAR</td>
<td>按域名分组、相同请求去重</td>
</tr>
<tr>
<td>Insomnia</td>
<td>导出文件 v3 / v4,含 workspace / group 层级</td>
</tr>
<tr>
<td>Hoppscotch</td>
<td>集合 JSON(数组或单对象)</td>
</tr>
<tr>
<td>Markdown</td>
<td>提取文中的 ```curl 代码块</td>
</tr>
<tr>
<td>OpsxAPI 备份</td>
<td>全量集合 + 环境,用于迁移恢复</td>
</tr>
</tbody>
</table>
<p>YApi、Apidoc、Apizza、Eolink 请先在原平台导出为 <strong>OpenAPI 或 Postman</strong> 格式,再导入本工具。</p>
<h2 id="sec-2">导入时自动完成</h2>
<table>
<thead>
<tr>
<th>原始内容</th>
<th>转换结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>OpenAPI <code>tags</code></td>
<td>目录分组</td>
</tr>
<tr>
<td>路径参数 <code>/pets/{petId}</code></td>
<td><code>{{petId}}</code> 变量 + 环境示例值</td>
</tr>
<tr>
<td><code>servers</code> 地址</td>
<td>当前环境 <code>baseUrl</code> 变量</td>
</tr>
<tr>
<td>requestBody schema</td>
<td>JSON 示例请求体</td>
</tr>
<tr>
<td>securitySchemes</td>
<td>Bearer / Basic / API Key 鉴权配置</td>
</tr>
<tr>
<td>Postman <code>variable</code></td>
<td>当前环境变量</td>
</tr>
</tbody>
</table>
<h2 id="sec-3">结果确认</h2>
<p>导入完成显示汇总:新建集合、接口数量、写入的环境变量与告警(如跳过的文件上传字段)。集合名重复时自动追加序号。</p>
</article>
<div class="pn-nav">
<a class="pn prev" href="/docs/mqtt"><span class="pn-label">← 上一页</span><span class="pn-title">MQTT</span></a>
<a class="pn next" href="/docs/export"><span class="pn-label">下一页 →</span><span class="pn-title">导出与代码生成</span></a>
</div>
</main>
<aside class="toc">
<div class="toc-title">本页目录</div>
<nav class="toc-nav">
<a class="toc-l2" href="#sec-1">支持格式</a>
<a class="toc-l2" href="#sec-2">导入时自动完成</a>
<a class="toc-l2" href="#sec-3">结果确认</a>
</nav>
</aside>
</div>
<script src="/docs/assets/docs.js" defer></script>
</body>
</html>