# 接口变更记录 — 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<Integer>`

### 接口名称更新

| 方法 | 路径 | 原名称 → 新名称 |
| --- | --- | --- |
| `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<String>`

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

**响应** `Result<Integer>`

---

## 📦 其他数据对象变更

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

### 保险服务

#### ✏️ InsuranceOrderVO

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

<details>
<summary>📁 全部变更文件 (点击展开)</summary>

```
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
```
</details>