# OpenAPI / Swagger 在线查看器 - 接口文档预览、校验与导出

> 免费在线查看 OpenAPI 3.x 与 Swagger 2.0（JSON / YAML）：按标签分组的接口列表与搜索、参数与请求体、$ref 模型树、示例 JSON、curl/fetch 片段，导出静态 HTML。

- 网址: https://qilingtools.com/zh/openapi-viewer
- 分类: 开发工具 (https://qilingtools.com/zh/dev)
- 标签: [开发](https://qilingtools.com/zh/tags/dev), [数据格式](https://qilingtools.com/zh/tags/data), [网络 HTTP](https://qilingtools.com/zh/tags/network)
- 最后更新: 2026-10-26
- 价格: 免费，无需注册
- 隐私: 在浏览器本地处理，文件不上传服务器

拿到一份 openapi.yaml 或 swagger.json，却不想为了看一眼就部署 Swagger UI？把文档粘贴进来或打开本地文件，工具会在浏览器里把它整理成可读的接口文档：顶部是标题、版本、描述、服务器地址和鉴权方式；左侧按标签分组列出全部接口，带彩色的请求方法标记，可按路径、摘要、operationId 或标签搜索；右侧显示选中接口的参数表、请求体和各状态码的响应。所有 $ref 引用都会被解析成可逐层展开的模型树，显示类型、必填、枚举、取值范围、readOnly 等约束，遇到循环引用会标出“↻”而不会无限展开，并按 schema 自动生成示例 JSON（请求体会跳过只读字段）。Swagger 2.0 的 body / formData 参数和 definitions 会自动转换成与 OpenAPI 3 相同的结构。“调试”面板可以选择服务器、填写参数和令牌，实时生成 curl 与 fetch 代码；勾选确认后也可以直接从浏览器发送请求（需要目标服务器允许跨域）。工具还会给出校验提示：无法解析的引用、缺少或重复的 operationId、只有参数名不同的重复路径、路径参数未定义等。最后可以一键导出一份独立的静态 HTML 文档发给同事。文档内容只在本地处理，不会上传。

## 使用步骤

1. 粘贴 OpenAPI / Swagger 的 JSON 或 YAML，或打开本地文件（也可先点“示例文档”看看效果）
2. 在左侧按标签浏览或搜索接口，查看参数、请求体、响应模型和示例 JSON
3. 在“调试”面板生成 curl / fetch 代码，或导出静态 HTML 文档

## 功能特点

- 支持 OpenAPI 3.0 / 3.1 与 Swagger 2.0，JSON 与 YAML 均可
- 按标签分组的接口列表，方法彩色标记，全文搜索
- $ref 解析为可展开的模型树，循环引用安全
- 根据 schema 自动生成示例 JSON（区分 readOnly / writeOnly）
- 校验提示：无法解析的引用、缺少或重复的 operationId、重复路径、路径参数不匹配
- 调试面板：服务器变量、参数、Bearer / Basic / API Key 鉴权，生成 curl 与 fetch
- 可选从浏览器直接发送请求并查看响应（受 CORS 限制）
- 一键导出单文件静态 HTML 文档

## 常见问题

### 和 Swagger UI、Redoc 有什么区别？

展示的内容类似，但这里不需要部署任何服务，也不用把文档上传到第三方网站：粘贴即看，全部在浏览器本地解析。另外会额外给出校验提示，并能导出一份不依赖任何脚本的静态 HTML 文档，方便发邮件或放进内网 Wiki。

### 支持外部文件引用（$ref: other.yaml#/...）吗？

不支持。为了不发起网络请求，只解析同一文档内的引用（以 # 开头的 JSON Pointer）。外部引用会在校验提示里列出；可以先用 swagger-cli bundle 或 redocly bundle 把多个文件合并成一个再粘贴。

### “发送请求”为什么失败了？

请求是从你的浏览器直接发往接口服务器的，本站不做中转。如果服务器没有返回允许当前来源的 CORS 响应头，浏览器会拦截响应，就会显示请求失败。这种情况下可以复制生成的 curl 命令到终端执行，结果是一样的。

### 循环引用的模型会怎样显示？

比如分类 Category 的 parent 字段又指向 Category，模型树展开到重复出现的地方会显示“↻ 循环引用”并停止，示例 JSON 也会在那里截断，所以再复杂的递归结构也不会卡死页面。

## 相关工具

- [JSON 格式化](https://qilingtools.com/zh/json): 免费在线 JSON 格式化：一键美化、压缩，实时语法校验并定位到出错行列，支持树形视图折叠、键名排序、转义与去转义、Unicode 转中文、复制下载，数据不上传。
- [Base64 编解码](https://qilingtools.com/zh/base64): 免费在线 Base64 编码解码工具：支持中文 UTF-8、URL 安全变体，文本与 Base64 互转，实时转换，本地处理不上传。
- [URL 编解码](https://qilingtools.com/zh/url-encode): 免费在线 URL 编码解码工具：encodeURIComponent 与 encodeURI 两种模式，处理中文、空格与特殊符号，本地实时转换不上传。
- [JWT 解析](https://qilingtools.com/zh/jwt): 免费在线 JWT 解析工具：解码 JWT 的 Header 与 Payload，展示过期时间、签发时间等，本地解析不上传，保护令牌安全。
- [时间戳转换](https://qilingtools.com/zh/timestamp): 免费在线 Unix 时间戳转换工具：时间戳与日期互转，自动识别秒/毫秒，显示本地时间、UTC、ISO 8601 和相对时间，实时更新。
- [哈希计算](https://qilingtools.com/zh/hash): 免费在线哈希/摘要计算工具：对文本或文件计算 SHA-1、SHA-256、SHA-384、SHA-512，使用浏览器加密接口本地完成，文件不上传。
- [UUID 生成](https://qilingtools.com/zh/uuid): 免费在线 UUID 生成器：使用加密安全随机数批量生成符合 RFC 4122 的 UUID v4，可大写、去连字符、加花括号，一键复制。
- [进制转换](https://qilingtools.com/zh/base-convert): 免费在线进制转换工具：二进制、八进制、十进制、十六进制及任意 2–36 进制互转，支持大整数（BigInt），本地实时计算。