# 接口变更记录 — 2026-03-25 13:19

> **提交** `4466a02` · **作者** wx · **时间** 2026-03-25 13:19:08 +0800
>
> feat: 天气服务迁移至和风天气API（支持经纬度查询）

## 变更总览

- **小程序聚合服务**
  - MpTrip (改1)
  - MpWeather (改2)
- **订单服务**
  - MpWeather (改2)

---

## 小程序聚合服务

### MpTrip

> 📖 **接口文档**: [http://192.168.100.236:8086/doc.html](http://192.168.100.236:8086/doc.html) → 标签 **「C端 - 行程接口」**

### ✏️ `GET` /mp/trip/weather — 天气查询（经纬度）

- 接口名称: ~~天气查询~~ → **天气查询（经纬度）**
- 参数: city(String) → longitude(BigDecimal), latitude(BigDecimal)

### MpWeather

> 📖 **接口文档**: [http://192.168.100.236:8086/doc.html](http://192.168.100.236:8086/doc.html) → 标签 **「C端 - 天气接口」**

### ✏️ `GET` /mp/weather/live — 根据经纬度获取实况天气

- 接口名称: ~~获取指定城市实况天气~~ → **根据经纬度获取实况天气**
- 参数: city(String) → longitude(BigDecimal), latitude(BigDecimal)

### ✏️ `GET` /mp/weather/forecast — 根据经纬度获取天气预报

- 接口名称: ~~获取指定城市天气预报~~ → **根据经纬度获取天气预报**
- 参数: city(String) → longitude(BigDecimal), latitude(BigDecimal)

---

## 订单服务

### MpWeather

> 📖 **接口文档**: [http://192.168.100.236:8084/doc.html](http://192.168.100.236:8084/doc.html) → 标签 **「内部天气接口(Feign)」**

### ✏️ `GET` /internal/mp/weather/live — 根据经纬度获取实况天气

- 接口名称: ~~获取指定城市实况天气~~ → **根据经纬度获取实况天气**
- 参数: city(String) → longitude(BigDecimal), latitude(BigDecimal)

### ✏️ `GET` /internal/mp/weather/forecast — 根据经纬度获取天气预报

- 接口名称: ~~获取指定城市天气预报~~ → **根据经纬度获取天气预报**
- 参数: city(String) → longitude(BigDecimal), latitude(BigDecimal)

---

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

```
A	hl-common/src/main/java/com/hulalv/common/config/FeignRetryConfig.java
A	hl-common/src/main/java/com/hulalv/common/weather/QWeatherClient.java
M	hl-common/src/main/java/com/hulalv/common/weather/WeatherInfo.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpTripController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpWeatherController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/feign/MpOrderFeignClient.java
M	hl-mp-service/src/main/java/com/hulalv/mp/feign/MpOrderFeignFallbackFactory.java
M	hl-order-service/src/main/java/com/hulalv/order/config/WeatherConfig.java
M	hl-order-service/src/main/java/com/hulalv/order/controller/MpWeatherController.java
M	hl-order-service/src/main/java/com/hulalv/order/job/DepartureReminderJob.java
M	hl-order-service/src/main/java/com/hulalv/order/service/WeatherService.java
```
</details>