JSON 整理与类型生成可运行案例
评论列表:从样本起草 Draft-07 Schema
从 评论列表 的样本推断字段与类型。样本无法证明全部必填项、合法范围和业务状态,发布前应补正常与异常样本,再用 Schema 校验工具核对。
试一试
在完整工具中打开 ↗示例工作台
JSON 整理与类型生成修改下方数据后重新运行
运行结果
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"properties": {
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"commentId": {
"type": "string"
},
"content": {
"type": "string"
},
"likes": {
"type": "integer"
},
"pinned": {
"type": "boolean"
},
"moderation": {
"type": "string"
},
"thread": {
"type": "object",
"properties": {
"parentId": {
"anyOf": [
{
"type": "null"
},
{
"type": "string"
}
]
},
"replies": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"parentId",
"replies"
]
}
},
"required": [
"commentId",
"content",
"likes",
"pinned",
"moderation",
"thread"
]
}
},
"summary": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"note": {
"type": "null"
}
},
"required": [
"total",
"note"
]
}
},
"required": [
"comments",
"summary"
]
}
},
"required": [
"ok",
"data"
]
}原例已核验,可修改输入后重新运行。
⌘ / Ctrl + Enter 运行01
场景与操作说明
评论内容和审核状态不应混用。本文只展示合成文本与结构,不能用样本中的 approved 判断真实内容已通过审核。
likes 是示例点赞数,0 与 null 或缺失的含义不同。
- 核对 评论列表 的字段层级,保留 commentId 的字符串类型。
- 修改一项输入并运行,观察结果中的值或路径如何变化。
- 载入对照样本,复现下面的变化;恢复原例会替换当前输入。
02
对照样本
对照样本没有 comments 元素,无法推断元素结构。比较两份 Schema,确认哪些约束来自样本证据,哪些仍需人工补充。
查看对照输入
{
"ok": true,
"data": {
"comments": [],
"summary": {
"total": 2,
"note": null
}
}
}对照样本的实际结果
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"properties": {
"comments": {
"type": "array",
"items": {}
},
"summary": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"note": {
"type": "null"
}
},
"required": [
"total",
"note"
]
}
},
"required": [
"comments",
"summary"
]
}
},
"required": [
"ok",
"data"
]
}