📄

OpenAPI 验证器

验证 OpenAPI 3.0/3.1 YAML/JSON 并定位错误

通用开发
🔒 100% 本地运行 — 你的数据不会离开当前页面
由 ToolsKit 编辑团队维护最近更新:2026年8月23日最近复核:2026年8月23日
OpenAPI YAML / JSON
校验结果

语法和结构问题会显示在这里。

工具说明

在浏览器本地检查 OpenAPI 3.0 和 3.1 的 YAML 或 JSON 文档,尽可能提供带行列位置的语法和常见结构错误。工具会检查必要元数据、路径格式及操作的 responses,帮助在评审前发现接口契约问题;它是聚焦常见结构的检查器,不替代所有厂商规则或外部引用解析。

常见问题

支持哪些 OpenAPI 版本?

支持以 YAML 或 JSON 编写的 OpenAPI 3.0.x 和 3.1.x 文档。

浏览器会检查哪些内容?

会解析语法并检查 info 元数据、paths、路径键格式以及操作是否声明 responses 等常见结构。

会解析外部引用吗?

不会。工具不会读取外部文件或远程引用,以保证浏览器本地检查的隐私和确定性。

错误会显示行列位置吗?

YAML 解析错误在能取得偏移量时会显示行列信息;结构错误会显示对应的 JSON 风格路径。

这是完整的官方 OpenAPI 一致性测试吗?

不是。它聚焦常见编写错误;如需完整一致性检查,还应在 CI 中使用官方或厂商验证器。

我的 API 定义会上传吗?

不会。YAML 解析和结构检查都在浏览器本地运行。

继续浏览