对一遍接口字段和文档｜前端工程师AI场景表格模板

要准备的

关于这件事怎么办

返回里字段顺序和文档不一样，要算差异吗？

字段顺序一般不影响使用，重点是字段名、类型和层级是否一致，以及文档有但返回缺失、返回多出未定义的字段。

嵌套对象里的字段怎么比对？

按层级逐层展开，比如 address.city 单独成行，层级不同但名字相同的字段要分开列，避免把子字段和顶层字段混在一起。

数组返回多条时以哪条为准？

默认取第一条做样本，也可以指定取几条；多条类型不一致时在差异说明里注明，由人确认是接口问题还是样本特例。

对一遍接口字段和文档需要准备什么？

需要填的是：JSON 来源、上传 JSON 材料、上传接口文档、比对范围、忽略字段、数组取几条。每一项点一下就行，多数不用打字。点「直接办这件事」就开工；没选全也能先办，回头补了随时能改。

能拿到什么成果？

交付形式是表格——平台直接做好表格，能下载成 Excel。在GPT中文网（www.gpt.com.cn）按字段填完即可拿到。文字类成果免费生成，免注册即可试。

什么情况下需要对一遍接口字段和文档？

手对字段容易漏掉嵌套和类型变化，联调时才发现展示错位。遇到这种情况，把信息按字段点选一遍，AI 按你点的出成品，不用自己琢磨怎么说。

适合谁用？

负责前后端联调、接口对接的网页前端工程师。不需要 AI 使用经验，按字段填完即可。