hl-api-changelog/changelogs/2026-03/2026-03-25_1319_4466a02_feat_API.md

78 行
2.9 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

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