数据与格式
Schema 与类型生成工具
接口对接时最烦的是照着 JSON 响应手写类型定义,字段一变还要逐个对照修改。这类工具从真实 JSON 样本推断类型:JSON 转 TypeScript、JSON 转 Go、JSON 转 Java、JSON 转 Python、JSON 转 Swift 生成接口或结构体,JSON 转实体类一次覆盖 Rust、C#、Dart 等语言,省去手写对齐字段的劳动。
如果需要的是校验规则而不是某种语言的类型,可以用 JSON Schema 生成器从样本推断字段类型生成对应版本的 Schema,再用 JSON Schema 校验检查数据,报错标出违反的字段路径。JSON Schema 差异比较能看出新旧两版 Schema 必填项和类型的变化,Schema 模拟数据生成器按约束生成可复现的数据,这些工具都在浏览器本地运行。
11 个工具
Schema 与类型生成工具常见问题
JSON 转 TypeScript 能处理多条样本吗?
可以,JSON 转 TypeScript 支持一次输入多条 JSON 样本,综合推断出更准确的接口类型,比如把可选字段和不同取值的字段合并成联合类型,而不是只按单条样本生成,这样得到的接口定义更贴近接口实际返回的各种情况。
JSON Schema 校验报错时怎么知道是哪个字段出的问题?
JSON Schema 校验会在报错信息里标出具体违反规则的字段路径,而不是只给一个笼统的错误提示,方便直接定位到数据里出问题的那个字段。可以先用 JSON Schema 生成器从一份正常样本生成基准 Schema,再拿来校验其他数据。
怎么在不改代码的情况下拿到符合 Schema 的测试数据?
用 Schema 模拟数据生成器,它按你提供的 JSON Schema 约束生成数据,同一份 Schema 和设置能重复生成一致的结果,适合拿来填测试环境或做前端联调,不需要等后端接口真正就绪。