31 lines
1.5 KiB
Markdown
31 lines
1.5 KiB
Markdown
# 2026-02-13 — API 字段漂移报告修正更新
|
||
|
||
## 日期
|
||
2026-02-13 (Asia/Taipei)
|
||
|
||
## 原始原因
|
||
上下文传递续接：前次对话中发现 settlement_records / recharge_settlements / payment_transactions 三个端点因使用 `pageSize`/`pageNo` 参数导致 HTTP 1400 失败。用户确认这些端点需要使用 `limit` 参数（最大 100）。
|
||
|
||
## 直接原因
|
||
需要用正确的 `limit` 参数重新调用这 3 个端点，提取实际 API 字段并与本地 JSON 样本比对，更新字段漂移报告。
|
||
|
||
## Changed
|
||
- `docs/reports/api_field_drift_report_20260213.json` — 更新 3 个实体的比对结果 + 摘要统计
|
||
- `docs/reports/api_field_drift_report_20260213.md` — 同步更新 MD 格式报告，新增漂移详情、分页参数兼容性说明
|
||
- 删除临时文件：`_retry_1400.py`、`_retry_goods.py`、`_field_drift_retry.py`、`_retry_results.json`
|
||
|
||
## 比对结果
|
||
| 实体 | 本地字段 | API 字段 | 新增 | 移除 |
|
||
|------|---------|---------|------|------|
|
||
| settlement_records | 86 | 91 | 5 | 0 |
|
||
| recharge_settlements | 86 | 91 | 5 | 0 |
|
||
| payment_transactions | 10 | 10 | 0 | 0 |
|
||
|
||
新增字段（settlement_records / recharge_settlements 共同）：
|
||
- `electricityAdjustMoney`、`electricityMoney`、`realElectricityMoney` — 电费相关
|
||
- `merVouSalesAmount`、`plCouponSaleAmount` — 商户券/平台券销售额
|
||
|
||
## Risk/Verify
|
||
- 风险：纯文档更新，无代码逻辑变更
|
||
- 验证：重新运行比对脚本可复现结果；检查 JSON 报告 summary 数值一致性
|