JSON Swiss 标志

JSON Swiss

Schema 模板库

显示 8 / 8 个 Schema

Application Configuration

配置复杂

Complete application configuration with all settings

51个字段 · 4层深度
configsettingsapplication+1
生成

Basic User Profile

用户管理简单

Simple user profile with essential information

7个字段 · 1层深度
userprofilebasic+1
生成

Complete User Profile

用户管理中等

Comprehensive user profile with personal and contact information

36个字段 · 3层深度
userprofilecomplete+2
生成

Financial Transaction

金融中等

Complete financial transaction record

37个字段 · 3层深度
transactionpaymentfinancial+1
生成

Order Details

电商复杂

Complete order with items, customer, and payment information

44个字段 · 3层深度
ordercheckoutpayment+1
生成

Paginated API Response

API中等

Standard paginated API response with metadata

20个字段 · 2层深度
apiresponsepagination+1
生成

Product Catalog

电商中等

E-commerce product with pricing and inventory

42个字段 · 3层深度
productcataloginventory+1
生成

Social Media Post

社交中等

Social media post with engagement metrics

37个字段 · 4层深度
socialpostengagement+1
生成

如何使用 JSON Schema 模板库（步骤指南）

浏览常见 payload（用户、商品、API 响应等）的 JSON Schema 模板，并进一步生成 Mock JSON、校验合同、将稳定样例转为强类型代码。

  1. 步骤 1：按场景搜索

    • 用搜索框按名称、tags 或场景关键词查找（例如“用户资料”“分页”“商品目录”）。
    • 结合分类、复杂度与 tags 快速缩小范围。

  2. 步骤 2：评估 Schema 结构

    • 查看关键字段、required、formats 与约束是否符合预期。
    • 优先选择与 API 合同结构相符的模板（不只看领域名称）。

  3. 步骤 3：复制或下载

    • 将 Schema 复制到仓库中，与 API 代码和文档一起版本化管理。
    • 下载为 .json 文件，便于分享或接入工具链。

  4. 步骤 4：生成 Mock 数据与 fixtures

    • 打开 Mock 数据生成器，生成用于测试与演示的真实感样例 JSON。
    • 用 seed + locale 让数据在不同环境可复现。

  5. 步骤 5：校验并生成代码

    • 在开发阶段用 Schema 校验真实 payload。
    • 基于稳定 JSON 样例生成 TypeScript/Java 等类型代码，让客户端/服务端保持一致。

关于 JSON Schema 特性的提示

  • 有些 Schema 会依赖更高级的关键字，例如 $ref, anyOf, oneOf, 以及 allOf。
  • 不同校验器对 Draft 与关键字的支持程度不一；在 CI 中建议使用完整的 JSON Schema validator 进行严格合同测试。
示例：Schema 模板 → Mock JSON 工作流
// 1) Pick a schema template (user-profile, product-catalog, etc.)
// 2) Open Mock Generator and configure locale + seed + batch size
// 3) Download mock-data.json and use it as a fixture

相关工具

生成 Schema、校验 payload、生成 Mock 数据，并产出强类型模型。

Mock 数据生成器

从 Schema 生成更真实的样例 JSON，用于测试、演示与原型。

JSON Schema 生成器

从 JSON 样例生成基础 Schema，并在生产前进一步完善约束。

JSON Schema 校验器

用 Schema 校验 JSON payload，迭代合同与约束。

JSON 格式化

生成 Schema 或代码前，先格式化并规范化 JSON 样例。

JSON 校验器

生成 Schema 或 Mock 前，先检查 JSON 语法并定位错误。

JSON 转 TypeScript 类型

从稳定 JSON 样例生成 TypeScript interfaces/types。

常见问题

什么是 JSON Schema 模板？

JSON Schema 模板是为常见数据结构（如用户资料、商品、API 响应等）预置的 Schema，适合作为你自定义 Schema 的起点，也可用于生成 Mock 数据。

我可以如何使用这些 Schema？

你可以复制或下载模板 Schema，直接在 Mock 数据生成器中生成样例数据，或在 Schema 校验器中用它校验真实 payload。

复杂度等级代表什么？

简单：字段少、嵌套浅；中等：包含嵌套对象与数组；复杂：嵌套更深、关联更多、约束更丰富。

可以修改这些模板吗？

模板本身是只读的，但你可以复制/下载后按需修改 JSON Schema，用于你的具体业务场景。

如何搜索到想要的 Schema？

使用搜索框按名称、描述、tags 或 use case 查找，并结合分类、复杂度与 tags 进一步缩小范围。

有哪些分类？

模板库包含用户管理、电商、API、配置、金融、社交等分类，每个分类下都有对应场景的 Schema。

如何从模板生成 Mock 数据？

点击模板上的“生成”，即可打开已预填 Schema 的 Mock 数据生成器；再配置记录条数与参数，即可快速产出更真实的样例数据。

这些模板兼容哪些 JSON Schema Draft？

模板遵循通用的 JSON Schema 约定，侧重实用性，并不严格绑定某个 Draft；可能省略部分高级关键字，请根据你的工具链按需调整。

如何快速找到合适的模板？

先用搜索框匹配名称/描述/tags/use case，再结合分类与复杂度筛选，最后按名称/分类/复杂度/最新排序进行精炼。

Schema 模板库 | JSONSwiss