核对接口文档字段和实际返回差异

示例：接口文档与实际返回字段对齐差异表（示意） 接口：GET /api/v1/orders/{id}，环境：测试 文档来源：Swagger 2.0，比对时间：××××-××-×× 统计：文档字段 18 个，实际返回 16 个；缺失字段 2 个，类型不符 1 个，必填差异 1 个；错误码文档 6 个，实际覆盖 4 个。 字段 | 文档定义 | 实际返回 | 差异类型 | 建议 orderId | string, 必填 | string | 无 | — amount | number | string | 类型不符 | 改代码返回 number 或改文档为 string items | array, 必填 | 未返回 | 缺失 | 确认空数组是否省略，改文档加示例 remark | string | 未返回 | 缺失 | 文档标可为空，建议文档注明不返回 status | enum[A,B,C] | D | 枚举不符 | 与对方确认 D 含义，补枚举 updatedAt | string(date-time) | 时间戳数字 | 类型不符 | 统一为 ISO 字符串或数字，改文档 错误码对照： 文档错误码 | 实际出现 | 覆盖情况 | 建议 40001 | 是 | 已覆盖 | — 40002 | 否 | 未覆盖 | 确认是否废弃 50001 | 是 | 已覆盖 | — 50003 | 否 | 未覆盖 | 补 curl 用例验证 文档修正稿（docx 摘要）： - items 字段补「可能不返回，表示空列表」说明 - remark 标注「成功时不返回」 - status 枚举增加 D，备注含义待确认 - updatedAt 类型改为 number（毫秒时间戳） 补充 curl 用例： 1) 正常：curl -X GET '…/orders/1' -H 'Authorization: Bearer …' 2) 空列表：curl -X GET '…/orders/2' … 3) 错误码 50003：curl -X GET '…/orders/999' … 4) 缺必填参数：curl -X GET '…/orders/' … 结论由持证人员核对后才能用：差异项需人工判断是真 bug 还是文档过时。