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 解析和结构检查都在浏览器本地运行。
继续浏览