hl-api-changelog/changelogs-v2/2026-06/15_保险订单详情与试算金额改String序列化-与列表对齐-管理后台.md

1.6 KiB

【字段类型对齐·管理后台】保险订单「详情」与「保费试算」金额字段改 String 序列化,与列表对齐

hl-ui保险订单详情 / 投保试算)| 服务hl-order-service-v3 insurance | PR #3842 已合并 dev-v3 + 部署测试服 + 实测 | 2026-06-15

⚠️ 关键说明(前端需对齐解析类型)

平台铁律:金额 JSON 出参一律用 String(避免大数/精度问题)。本次把保险几处遗漏的金额字段补齐为 String,与列表口径一致

端点 字段
详情 GET /v3/admin/insurance/orders/{id} totalPremium / premium JSON 数字 10.80 JSON 字符串 "10.80"
投保试算 InsuranceTrialPriceRespVO premium JSON 数字 JSON 字符串

列表 GET /v3/admin/insurance/listtotalPremium/premium 在上一版 (#3831) 已是 String。本次修复前,列表返字符串、详情返数字,前端复用同名字段会遇到类型不一致;现已统一。

1. 前端需要做的

  • 详情页 / 试算结果里读 totalPremiumpremium 时按字符串处理(与列表一致)。若之前对详情按 number 解析/做运算,请改成先 Number(x) 再算(或直接展示字符串)。
  • 其余字段、路径、结构不变

验证(测试服实测,过网关 9443 + 真 admin token

  • 列表 /v3/admin/insurance/listtotalPremium="10.80"premium="10.80"String
  • 详情 /v3/admin/insurance/orders/{id}totalPremium="10.80"premium="10.80"String 两端一致