Generates diffable API reports…

# OpenAPI v2.3 → v2.5 订单与支付模块 Diff 报告说明

⚠️ 重要前提

您未上传或提供 v2.3 / v2.5 的实际 OpenAPI 文档内容，我无法凭空“编造”两版接口的差异——那样会产生虚假报告。以下先给出可直接落地的对比方案 + diff 报告模板，您把文档发我后即可生成真实结果。

一、推荐的对比方法

方式1：自动化脚本对比（推荐，可diff）

• 使用 oasdiff（开源工具，专为 OpenAPI 设计）：

```

oasdiff breaking openapi-v2.3.yaml openapi-v2.5.yaml

```

• 或 openapi-diff（Java/Node 版本），输出新增、删除、修改接口清单
• 输出天然是结构化 diff 格式，可直接存档评审

方式2：脚本提取接口清单后 diff

• 用 Python + pyyaml 遍历 paths 字段，提取每版接口列表：
• 键：路径 + method
• 值：operationId、参数、请求体 schema
• 用 set 的差集求新增/删除，逐字段比对求修改

二、可 diff 的报告模板（生成后长这样）

```markdown

# API Diff Report: v2.3 -> v2.5

订单模块 /order/*

新增

• POST /v2/orders/batch-query （批量查询）

删除

• GET /v1/orders/{id}/legacy-detail

修改

• POST /v2/orders/refund：请求体新增字段 refundReason(必填)

支付模块 /payment/*

新增

• POST /v2/payments/{id}/split

删除

• DELETE /v1/payments/pre-auth

修改

• POST /v2/payments/notify：回调签名字段 algorithm 值域变更

破坏性变更汇总（Breaking Changes）

• 删除接口 N 个：需评估存量调用方
• 必填字段新增 M 个：需通知调用方适配

```

三、需要您提供的内容

1. v2.3、v2.5 两版文档（YAML/JSON 原文件最佳，URL 或粘贴均可）

2. 是否需要同时输出参数级、响应体级的变更明细

请上传文档，我立即生成真实的 diff 报告。