比对接口文档和代码差异

示例：接口文档与代码差异清单（示意数据） 比对基准：代码分支 feature/user-v2，文档版本 v1.8，基准日 ××月××日。 一、差异清单 接口路径 | 方法 | 差异类型 | 代码实际 | 文档记载 | 判定 | 建议动作 /api/user/profile | GET | 响应字段 | 新增 avatarUrl、vipLevel | 无 | 文档滞后 | 补进响应示例与字段表 /api/order/create | POST | 请求参数 | quantity 为必填整数 | 非必填 | 文档滞后 | 改为必填并加类型说明 /api/pay/callback | POST | 状态码 | 成功返回 200，失败返回 422 | 统一写 200 | 文档滞后 | 补 422 说明 /api/goods/list | GET | 请求参数 | pageSize 上限 100 | 未写上限 | 文档滞后 | 补取值范围 /api/login | POST | 鉴权标注 | 需要 Bearer Token | 未标注 | 文档滞后 | 加鉴权说明 /api/report/export | GET | 路径 | /api/report/export-v2 | /api/report/export | 疑似代码问题 | 与负责人核对是否漏改路由 /api/cart/items | DELETE | 响应字段 | 返回 deletedCount | 返回 success | 疑似代码问题 | 确认字段改名是否有意 小计：文档滞后 5 项，代码疑点 2 项。 二、待更新文档段落（摘录） 1）/api/user/profile 响应示例在原有字段后追加："avatarUrl": "https://cdn.example.com/a.png"，"vipLevel": 2；字段表补两行，类型分别为 string、integer。 2）/api/order/create 请求参数表 quantity 行改为：必填是，类型 integer，说明「购买数量，最小 1，最大 999」。 3）/api/pay/callback 响应说明拆为成功 200 与失败 422 两行，422 附错误码示例。 4）/api/goods/list 的 pageSize 说明补「默认 10，最大 100」。 5）/api/login 在接口说明首行加「鉴权方式：请求头 Authorization: Bearer <token>」。 三、需人工核对 /api/report/export 与 /api/cart/items 两项差异方向不明，请与接口负责人确认后再改文档。