diff --git a/changelogs/2026-03/2026-03-24_1554_f794175_fix.md b/changelogs/2026-03/2026-03-24_1554_f794175_fix.md new file mode 100644 index 0000000..aa0f364 --- /dev/null +++ b/changelogs/2026-03/2026-03-24_1554_f794175_fix.md @@ -0,0 +1,79 @@ +# 接口变更记录 — 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](http://192.168.100.236:8098/doc.html) → 标签 **「保险管理」** + +### 🆕 `POST` /admin/insurance/upload-missing-pdfs — 补传旧保单PDF到OSS + +> 将所有已承保但未上传PDF的保单,异步下载PDF并上传到OSS。用于历史数据迁移。 + +**响应** `Result` + +### 接口名称更新 + +| 方法 | 路径 | 原名称 → 新名称 | +| --- | --- | --- | +| `GET` | `/admin/insurance/recharge-url` | 获取保游网充值链接(旧接口,保留兼容) → **获取保游网充值链接(已废弃)** | + +### InternalInsurance + +> 📖 **接口文档**: [http://192.168.100.236:8098/doc.html](http://192.168.100.236:8098/doc.html) → 标签 **「【内部接口】保险(Feign调用)」** + +### 🆕 `GET` /internal/insurance/policy/{id}/download — 下载单张保单PDF(内部调用) + +> 内部服务间调用。从保游网下载指定保险订单的电子保单PDF,以Base64编码返回。 + +**参数** + + - `{insuranceOrderId}` (`Long`) — 路径参数:保险订单ID + +**响应** `Result` + +### 🆕 `POST` /internal/insurance/upload-missing-pdfs — 补传旧保单PDF到OSS(内部调用) + +**响应** `Result` + +--- + +## 📦 其他数据对象变更 + +> 以下变更未直接关联到本次接口变更,但可能影响现有接口的请求/响应 + +### 保险服务 + +#### ✏️ 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 +``` +
\ No newline at end of file