OpenAPI 基础检查
本地处理任务练习:区分基础结构检查与完整接口验证
使用虚构 OpenAPI 3.1 JSON;工具只核对 openapi、info 与 paths 的基础字段,不执行接口。
{
"openapi": "3.1.0",
"info": {
"title": "Example API",
"version": "1.0.0"
},
"paths": {
"/health": {
"get": {
"responses": {
"200": {
"description": "OK"
}
}
}
}
}
}预期观察:validBasicStructure 为 true,issues 为空;只表示本工具的基础字段检查通过,不验证完整规范、引用、业务授权或接口实际响应。
缺少 paths 的失败样例可解析,但 validBasicStructure 为 false 且 issues 包含“缺少 paths”。按真实接口定义补齐后复查;不要仅加空字段就认定接口正确。
完成条件:核对基础检查结果与问题列表,再在自己的规范校验和接口测试流程中验证操作、参数、响应与授权。
保存接口检查结果与待验证项本地处理
数据范围与复查方法
每段 JSON/YAML 最多 512 KiB、嵌套最多 100 层;JWT原始文本最多32 KiB,按解码后的JSON检查。同一对象的重复键、非安全整数、负零、溢出及转换后十进制数值改变的输入会被拒绝。普通 0.1 和字符串编号可以处理;缩进、数字尾零及指数写法可能变化,不是字节级或任意精度无损转换。
拒绝时保留原文,先用 文本对比 核对;只有数据契约允许时才把标识改为字符串,不要为通过工具删除字段或更改类型。
YAML 仅支持 1.2、字符串映射键与可核对的十进制数值;暂不支持别名、显式标签或十六/八进制数值。转换不保留注释与排版。
处理结果
等待输入填写内容后,结果会显示在这里。
