分类

JSON Schema 生成器

从示例 JSON 自动推断 JSON Schema,支持手动调整并验证数据

适合 API 开发者和数据工程师。可先自动推断,再粘贴调整后的 Schema 重新验证。

示例结果

1 个示例

从 API 返回推断 Schema

把示例响应转换为可复用的 JSON Schema,并立即执行校验

{
  "summary": {
    "valid": true
  },
  "inferredSchema": {
    "type": "object"
  }
}
查看输入参数
{ "sampleJson": "{\n \"id\": 101,\n \"email\": \"[email protected]\",\n \"roles\": [\n \"admin\",\n \"user\"\n ],\n \"profile\": {\n \"active\": true\n }\n}", "draft": "2020-12", "inferEnums": true, "detectFormats": true, "validateAdjustedSchema": true }

关键信息

分类
Development
输入类型
textarea, select, checkbox
输出类型
json
样本覆盖
4
支持 API
Yes

概览

JSON Schema 生成器是一款专为 API 开发者和数据工程师设计的实用工具,能够根据您提供的示例 JSON 数据自动推断并生成对应的 JSON Schema,并支持手动调整与实时校验,确保数据结构定义准确无误。

适用场景

  • 需要为现有的 API 响应数据快速编写规范化的 JSON Schema 时。
  • 在进行数据建模或定义接口契约,需要从示例数据提取结构定义时。
  • 修改了 JSON Schema 定义后,需要立即验证其是否兼容原始示例数据时。

工作原理

  • 在“示例 JSON”区域粘贴您的数据对象。
  • 勾选“从数组推断枚举”或“识别常见格式”以增强 Schema 的精确度。
  • 点击生成后,系统将自动推断出 Schema,您可直接在“调整后的 Schema”中进行手动优化。
  • 开启“使用当前 Schema 校验示例数据”功能,即可实时确认 Schema 与数据的匹配状态。

使用场景

快速生成 API 文档所需的 JSON Schema 定义。
将后端返回的复杂 JSON 响应转化为标准化的数据结构模型。
在开发过程中快速验证数据结构变更是否符合既定 Schema 规范。

用户案例

1. API 响应结构建模

后端开发工程师
背景原因
需要为新开发的 REST API 编写 OpenAPI 文档,但手动编写复杂的嵌套 Schema 容易出错。
解决问题
快速从现有的 API 响应示例中提取出准确的 Schema 结构。
如何使用
粘贴 API 响应 JSON,勾选“识别常见格式”,生成后直接复制 Schema 到 Swagger 文档中。
示例配置
{"draft": "2020-12", "detectFormats": true}
效果
获得了一份包含正确数据类型、嵌套对象定义及格式校验的 JSON Schema,大幅提升了文档编写效率。

用 Samples 测试

json

相关专题

常见问题

该工具支持哪些 JSON Schema 草案版本?

目前支持 2020-12 和 Draft-07 两个主流版本,您可以根据项目需求在选项中进行切换。

“从数组推断枚举”有什么作用?

开启此项后,如果数组中的元素是固定的字符串或数字,工具会自动将其转换为 enum 类型,限制字段的可选值范围。

我可以手动修改生成的 Schema 吗?

可以。生成后您可以直接在“调整后的 Schema JSON”输入框中进行编辑,并重新运行校验以确保逻辑正确。

工具如何处理日期或邮箱等特殊格式?

勾选“识别常见格式”后,工具会自动检测字符串内容,若符合标准格式,将自动在 Schema 中添加 format 属性(如 date-time 或 email)。

校验功能会返回什么结果?

校验功能会返回一个包含验证状态的 JSON 对象,明确指出当前 Schema 是否能够成功验证您提供的示例数据。

API 文档

请求端点

POST /zh/api/tools/json-schema-generator

请求参数

参数名 类型 必填 描述
sampleJson textarea -
draft select -
inferEnums checkbox -
detectFormats checkbox -
adjustedSchemaJson textarea -
validateAdjustedSchema checkbox -

响应格式

{
  "key": {...},
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
JSON数据: JSON数据

AI MCP 文档

将此工具添加到您的 MCP 服务器配置中:

{
  "mcpServers": {
    "elysiatools-json-schema-generator": {
      "name": "json-schema-generator",
      "description": "从示例 JSON 自动推断 JSON Schema,支持手动调整并验证数据",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=json-schema-generator",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

你可以串联多个工具,比如:`https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`,最多20个。

如果遇见问题,请联系我们:[email protected]