OpenAPI验证器能做什么？
OpenAPI验证器是一款免费在线开发者工具，能够实时验证OpenAPI/Swagger API文档的规范合规性。它检查必填字段、字段类型、引用路径有效性、HTTP方法合法性、状态码格式、Schema结构等，精准定位错误位置。支持OpenAPI 3.0/3.1和Swagger 2.0，自动检测版本。适用于API开发者编写和调试API文档，确保文档符合OpenAPI规范。所有验证在浏览器本地完成，API文档内容绝不上传服务器。
核心功能
- 版本自动检测：自动识别OpenAPI 3.0/3.1和Swagger 2.0，应用对应验证规则
- 必填字段检查：验证openapi/info/paths等必填字段是否存在且格式正确
- 引用有效性：检查$ref引用路径是否指向文档中存在的定义
- HTTP方法验证：验证paths下的HTTP方法是否合法（get/post/put/delete等）
- Schema结构检查：验证Schema对象的type/properties/items等字段格式
使用教程
1. 在输入框中粘贴OpenAPI/Swagger文档内容（支持JSON和YAML格式）。
2. 点击"验证"或使用Ctrl+Enter快捷键，工具立即分析文档。
3. 查看验证结果：统计信息显示错误/警告数量，详细列表标注问题位置。
4. 根据错误提示修复文档，重新验证直到全部通过。
5. 点击"复制报告"或"下载报告"保存验证结果。
应用场景
场景1：API文档编写
API开发者在编写OpenAPI文档时，实时验证规范合规性，减少文档错误，提高API文档质量。
场景2：API设计评审
团队在API设计评审时，用此工具快速检查文档是否符合规范，确保设计一致性。
场景3：API网关配置
运维人员在配置API网关（如Kong、AWS API Gateway）前，验证OpenAPI文档格式，避免导入失败。
扩展知识
OpenAPI Specification（OAS，原名Swagger Specification）是REST API的描述标准，当前主流版本为3.0.x和3.1.x。OpenAPI 3.0基于JSON Schema draft-04，3.1基于draft-2020-12。核心结构包括：openapi（版本）、info（元信息）、servers（服务器列表）、paths（API路径）、components（可复用组件）、security（安全方案）、tags（标签分组）。$ref引用用于避免重复定义，格式为#/components/schemas/XXX。Swagger 2.0是旧版规范，结构略有不同（swagger字段、definitions而非components）。