hl-api-changelog/changelogs/2026-03/2026-03-24_1554_f794175_fix.md

接口变更记录 — 2026-03-24 15:54

提交 f794175 · 作者 wx · 时间 2026-03-24 15:54:33 +0800

fix: 保险服务余额查询超时优化 + 充值接口废弃标记

变更总览

• 保险服务
  • AdminInsurance (+1, 名1)
  • InternalInsurance (+2)

---

保险服务

AdminInsurance

📖 接口文档: http://192.168.100.236:8098/doc.html → 标签 「保险管理」

🆕 POST /admin/insurance/upload-missing-pdfs — 补传旧保单PDF到OSS

将所有已承保但未上传PDF的保单，异步下载PDF并上传到OSS。用于历史数据迁移。

响应 Result<Integer>

接口名称更新

方法	路径	原名称 → 新名称
GET	/admin/insurance/recharge-url	获取保游网充值链接(旧接口,保留兼容) → 获取保游网充值链接(已废弃)

InternalInsurance

📖 接口文档: http://192.168.100.236:8098/doc.html → 标签 「【内部接口】保险（Feign调用）」

🆕 GET /internal/insurance/policy/{id}/download — 下载单张保单PDF(内部调用)

内部服务间调用。从保游网下载指定保险订单的电子保单PDF，以Base64编码返回。

参数

• {insuranceOrderId} (Long) — 路径参数：保险订单ID

响应 Result<String>

🆕 POST /internal/insurance/upload-missing-pdfs — 补传旧保单PDF到OSS(内部调用)

响应 Result<Integer>

---

📦 其他数据对象变更

以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应

保险服务

✏️ InsuranceOrderVO

• 🆕 policyPdfUrl (String) — 保单PDF的OSS链接（.pdf结尾，可直接访问）

📁 全部变更文件 (点击展开)

M	hl-insurance-service/pom.xml
M	hl-insurance-service/src/main/java/com/hulalv/insurance/config/RestTemplateConfig.java
M	hl-insurance-service/src/main/java/com/hulalv/insurance/constant/InsuranceConstants.java
M	hl-insurance-service/src/main/java/com/hulalv/insurance/controller/AdminInsuranceController.java
M	hl-insurance-service/src/main/java/com/hulalv/insurance/controller/InternalInsuranceController.java
M	hl-insurance-service/src/main/java/com/hulalv/insurance/entity/InsuranceOrder.java
M	hl-insurance-service/src/main/java/com/hulalv/insurance/service/BaoyouApiClient.java
M	hl-insurance-service/src/main/java/com/hulalv/insurance/service/InsuranceOrderService.java
A	hl-insurance-service/src/main/java/com/hulalv/insurance/service/PolicyPdfUploadService.java
M	hl-insurance-service/src/main/java/com/hulalv/insurance/vo/InsuranceOrderVO.java
M	hl-insurance-service/src/test/java/com/hulalv/insurance/service/BaoyouApiClientTest.java