开始之前
边看边操作在 JSON 转代码 中打开实际工作区→
单份样例无法描述接口的全部返回情况。自动生成可以省去重复输入,但接口契约和真实数据分布仍然是最终依据。
使用有代表性的样例
样例应包含嵌套对象、数组、null 和可能缺失的字段。
示例
sample.json选择目标语言
根据代码库选择字段命名和序列化约定。
示例
Go json tags / TypeScript interfaces复查含义不明确的值
字符串可能实际代表日期、枚举、小数或不透明 ID,自动生成无法判断全部业务语义。
示例
"created_at": "2026-08-11T10:00:00Z"补充校验和测试
把生成结果当作初稿,用多份 Payload 和公开 Schema 做契约测试。
示例
contract tests要点总结
- 样例展示数据,不等于完整契约。
- null 与数字范围需要人工确认。
- 序列化字段名应保持稳定。