开始之前

单份样例无法描述接口的全部返回情况。自动生成可以省去重复输入,但接口契约和真实数据分布仍然是最终依据。

边看边操作在 JSON 转代码 中打开实际工作区
01

使用有代表性的样例

样例应包含嵌套对象、数组、null 和可能缺失的字段。

示例
sample.json
02

选择目标语言

根据代码库选择字段命名和序列化约定。

示例
Go json tags / TypeScript interfaces
03

复查含义不明确的值

字符串可能实际代表日期、枚举、小数或不透明 ID,自动生成无法判断全部业务语义。

示例
"created_at": "2026-08-11T10:00:00Z"
04

补充校验和测试

把生成结果当作初稿,用多份 Payload 和公开 Schema 做契约测试。

示例
contract tests
要点总结
  • 样例展示数据,不等于完整契约。
  • null 与数字范围需要人工确认。
  • 序列化字段名应保持稳定。