JSON 模式生成器

推断擅长处理的内容

• 类型：string、number、integer、boolean、null、array、object。
• 可空性：某字段在一个样本中为 null、在另一个样本中为字符串时，会变为 ["string", "null"]。
• 数组元素：同构数组生成单个 items 模式；异构数组生成 prefixItems。
• 枚举（enum）：若所有观测值都来自一个较小的集合（可配置，默认 10 个不同的值），则输出 enum。
• 必填：存在多个样本时，键的交集成为 required；只有一个样本时，除非你选择不这样做，否则所有键都为必填。
• 格式：与 ISO-8601 日期、电子邮件或 URI 相匹配的字符串会被推断出 format。

推断无法得知的内容

• 意图与示例之别：样本 age: 25 会推断出 type: integer，但无法得知你是否也接受 null。请提供覆盖边界情况的多个样本。
• 约束：minLength、maximum、pattern，这些需要你手动添加。推断不会从样本中猜测取值范围。
• 业务逻辑：“这三个字段中必须恰好设置一个”需要用 oneOf 表达，无法推断。
• 引用：生成器输出扁平的模式。若想把重复的结构抽取到 $defs 中，请在生成之后再做。

输出示例

从单个样本：

{ "name": "Alice", "age": 30, "tags": ["admin", "user"] }

推断出的模式（draft 2020-12）：

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "integer" },
    "tags": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["name", "age", "tags"]
}

常见错误

• 仅从单个样本推断。 模式会过拟合，每个字段都变为必填，且不容忍 null。请始终提供至少 5 到 10 个多样化的样本。
• 想要 number 时却用了 integer。 若任一样本含有小数，推断类型会变为 number；若全部为整数，则为 integer。对于两者皆可的字段，请包含一个含小数的样本。
• 遗漏可选字段。 在 5 个样本中有 4 个包含、1 个缺失的字段会被视为可选，这是有意的。若 5 个样本恰好都包含它，即便它在你的 API 中其实是可选的，模式也会将其标记为必填。