跳到主要内容

JSON Schema 示例数据生成器

API reference

根据 JSON Schema 生成示例 JSON 数据,适用于 API 文档、模拟响应和测试用例。结果基于种子生成,相同的 Schema、种子和设置始终产生完全一致的输出。全部在浏览器中运行。

输入

超过一条时,结果会包裹在数组中(NDJSON 模式下每行一条)。

相同的 Schema、种子和设置始终生成相同的数据。更改种子即可重新生成。

防止递归 Schema(指向自身的 $ref)无限嵌套。

输出

示例数据
 
这对您有帮助吗?

使用此工具的更多方式

REST API

curl -X POST https://api.iotools.cloud/v1/tool/json-schema-sample-generator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "schema": "{\"type\":\"object\",\"required\":[\"id\",\"email\"],\"prop…",
    "count": "1",
    "format": "pretty",
    "optional": "all",
    "seed": "42",
    "maxDepth": "6"
  }'

替换成您账户中的密钥。工具的字段即为请求体——没有额外包装。

让 AI 代理执行

Use the IOTools `json-schema-sample-generator` tool (JSON Schema Sample Generator) on this input:

YOUR_INPUT_HERE

将此粘贴给任何已连接 IOTools MCP 服务器的代理,再加上您的输入内容。

嵌入式小组件

<iframe
  src="https://iotools.cloud/embed/json-schema-sample-generator/"
  width="100%" height="520" frameborder="0" scrolling="no" loading="lazy"
  title="JSON Schema 示例数据生成器 — iotools.cloud"
  sandbox="allow-scripts allow-forms allow-same-origin allow-downloads allow-popups allow-popups-to-escape-sandbox"
  allow="clipboard-write"
  style="width:100%;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden"></iframe>
<script src="https://iotools.cloud/embed.js" async></script>

把它放到您自己的页面上——免费,无需密钥,只需保留一个反向链接。

每次 API/MCP 调用费用5 积分起
需要更多积分?查看定价

也可通过

使用指南

将 JSON Schema 转换为真正可用的示例数据,适用于 API 文档中的载荷、模拟响应、前端占位数据和测试用例。粘贴 Schema,即可获得有效的 JSON。不会上传任何内容,生成器完全在浏览器中运行。

输出是**基于种子(seeded)**的,这一点是大多数示例生成器所欠缺的:相同的 Schema、种子和设置始终生成逐字节相同的数据。这意味着你可以将结果作为固定测试数据提交到仓库,之后重新生成时不会产生杂乱的差异。需要不同的数据集时,只需更改种子。

使用方法

  1. 将 JSON Schema 粘贴到输入框中。
  2. 如果需要多条记录,请将样本数量向上拖动——2 条或以上会被包裹在数组中(NDJSON 模式下每行一条)。
  3. 选择输出格式:美化 JSON、压缩 JSON,或用于填充数据库或日志管道的 NDJSON。
  4. 设置可选属性,以控制示例与必填字段集合的接近程度。
  5. 复制或下载结果。

设置

  • 种子 — 任意文本。相同输入,相同输出。更改即可重新生成。
  • 可选属性 — 全部包含 会填充每个声明的属性;仅必填 只输出 required 中列出的键(这是检验使用方能否处理最小载荷的好方法);随机包含 会让每个样本各不相同,更接近真实流量。
  • 最大深度 — 递归到何处为止,之后以空对象/数组收尾。如果 $defs 中的条目引用了自身(例如树节点、评论线程),没有此限制就会无限嵌套。

生成器支持的内容

type(包括类型数组)、properties、required、items(单一 Schema 形式和元组形式)、enum、const、default、examples、oneOf、anyOf、allOf,以及指向 $defs 或 definitions 的本地 $ref 指针。数值约束(minimum、maximum、exclusiveMinimum、exclusiveMaximum、multipleOf)、字符串约束(minLength、maxLength)和数组约束(minItems、maxItems、uniqueItems)均会生效。

固定值的优先级依次为:const、default、examples,最后是从 enum 中选取。因此,将 "type": {"const": "user"} 固定的 Schema 始终得到 "user",而不是随机词。

为什么数值看起来很真实,而不是 "string1"?

有两个信号来源。首先是 format——email、uri、uuid、date、date-time、time、duration、hostname、ipv4、ipv6 和 json-pointer 都会生成格式正确的值。没有 format 时,则使用属性名:名为 email、createdAt、city、phone、price 或 id 的字段会得到与其名称相符的合理值。这使生成的 API 文档更易读。

支持 pattern 吗?

不支持。根据任意正则表达式合成字符串是另一个问题,错误的猜测比明显的占位符更糟。只有 pattern 的字符串会退回到词库中的单词。如果需要值精确匹配,请添加 format、enum 或 default。

支持哪些 JSON Schema 草案?

上述关键字在 Draft-07、2019-09 和 2020-12 中通用,因此这三者的 Schema 均可使用。$defs 和旧版的 definitions 都会被解析。远程 $ref URL 不会被获取——请先将其内联,因为这里不会访问网络。

相关工具

反向操作——从已有数据推断 Schema——请使用 JSON Schema Generator。要检查载荷是否真正符合某个 Schema,请使用 JSON Schema Validator。如果不想编写任何 Schema,只想要模拟记录,Fake Data Generator 可以接受一个简单的字段列表。

jsonjson-schemasample datamock datatest datafixturesapigenerator

喜欢这些工具?去掉广告吧。

一次性付款即可永久移除您账户中的所有广告。无需订阅,不追踪。