wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态
hl-api-changelog/changelogs/2026-03/2026-03-25_1358_96c4b97_feat.md

13 KiB
原始文件 永久链接 Blame 文件历史

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

提交 96c4b97 · 作者 wx · 时间 2026-03-25 13:58:29 +0800

feat: 订单交通信息（接送站）— 对接飞常准航班/火车实时动态

变更总览

  • hl-transport-service
    • 🆕 InternalTransport (+2 接口)
  • 小程序聚合服务
    • 🆕 MpOrderTransport (+2 接口)
  • 订单服务
    • 🆕 AdminOrderTransport (+5 接口)
    • 🆕 InternalOrderTransport (+2 接口)

hl-transport-service

🆕 新增: InternalTransport

📌 GET /internal/transport/flight — 按航班号查询航班动态

参数

  • flightNo (String) — 查询参数
  • date (String) — 查询参数

响应 Result<List<FlightVO>>

字段 类型 说明
flightNo String 航班号
airline String 航空公司名称
category String 航班属性：国内/国际/地区
departAirportCode String 出发机场三字码
arriveAirportCode String 到达机场三字码
departAirport String 出发机场名称
arriveAirport String 到达机场名称
departCity String 出发城市
arriveCity String 到达城市
planDepartTime String 计划起飞时间（yyyy-MM-dd HH:mm:ss）
planArriveTime String 计划到达时间（yyyy-MM-dd HH:mm:ss）
actualDepartTime String 实际起飞时间（yyyy-MM-dd HH:mm:ss）
actualArriveTime String 实际到达时间（yyyy-MM-dd HH:mm:ss）
status String 航班状态：计划/起飞/到达/延误/取消/返航/备降等
stopFlag String 是否经停：0不经停，1经停1次，n经停n次
shareFlag String 是否共享航班：0否，1是
shareFlightNo String 共享航班号（实际承运航班号）
departTerminal String 出发航站楼
arriveTerminal String 到达航站楼
boardGate String 登机口
arriveExit String 到达出口
departTimezone String 出发时区偏移（秒）
arriveTimezone String 到达时区偏移（秒）

📌 GET /internal/transport/train — 按车次查询火车动态

参数

  • trainNo (String) — 查询参数
  • date (String) — 查询参数

响应 Result<List<TrainVO>>

字段 类型 说明
trainNo String 车次
departStation String 出发车站
arriveStation String 到达车站
shutdown String 是否停运：0否，1是
planDepartTime String 计划出发时间
planArriveTime String 计划到达时间
estimatedDepartTime String 预计出发时间
estimatedArriveTime String 预计到达时间
actualDepartTime String 实际出发时间
actualArriveTime String 实际到达时间
departStatus String 出发状态：计划/正点/晚点/出发
arriveStatus String 到达状态：计划/正点/晚点/到达
duration Integer 运行时长（分钟）
stops List<TrainStopVO> 经停站列表

小程序聚合服务

🆕 新增: MpOrderTransport

📖 接口文档: http://192.168.100.236:8086/doc.html → 标签 「小程序-订单交通信息」

📌 GET /mp/order/{orderId}/transports — 查看订单交通信息（含实时动态）

返回订单的去程/回程交通信息，自动从飞常准查询实时航班/火车状态

参数

  • {orderId} (Long) — 路径参数：订单ID

响应 Result<List<Map<String, Object>>>

📌 POST /mp/order/{orderId}/transport — 填写交通信息

用户填写去程/回程的航班或火车信息。

参数

  • {orderId} (Long) — 路径参数：订单ID

响应 Result<Map<String, Object>>

订单服务

🆕 新增: AdminOrderTransport

📖 接口文档: http://192.168.100.236:8084/doc.html → 分组 「3.1 订单管理」 → 标签 「订单交通信息（接送站）」

📌 GET /admin/order/admin/order

📌 POST /admin/order/{orderId}/transport — 添加交通信息

为订单添加去程/回程的航班或火车信息，用于安排接送站。

参数

  • {orderId} (Long) — 路径参数：订单ID

请求体 OrderTransportRequest

字段 类型 说明
legType String 行程段：OUTBOUND=去程接站, RETURN=回程送站
transportType String 交通类型：FLIGHT=航班, TRAIN=火车
transportNo String 航班号或车次
departureStation String 出发站/机场
arrivalStation String 到达站/机场
travelDate LocalDate 乘坐日期
remark String 备注

响应 Result<OrderTransportVO>

字段 类型 说明
transportId String 交通信息ID
orderId String 订单ID
legType String 行程段：OUTBOUND=去程接站, RETURN=回程送站
transportType String 交通类型：FLIGHT=航班, TRAIN=火车
transportNo String 航班号或车次
departureStation String 出发站/机场
arrivalStation String 到达站/机场
travelDate LocalDate 乘坐日期
remark String 备注
createdByType String 填写人类型：ADMIN/USER
createdAt LocalDateTime 创建时间
planDepartTime String 计划出发时间
planArriveTime String 计划到达时间
actualDepartTime String 实际/预计出发时间
actualArriveTime String 实际/预计到达时间
liveStatus String 状态（如：计划/起飞/到达/延误/晚点）
extraInfo Map<String, String> 航班额外信息：航站楼/登机口/出口等

📌 PUT /admin/order/transport/{transportId} — 编辑交通信息

参数

  • {transportId} (Long) — 路径参数：交通信息ID

请求体 OrderTransportRequest

字段 类型 说明
legType String 行程段：OUTBOUND=去程接站, RETURN=回程送站
transportType String 交通类型：FLIGHT=航班, TRAIN=火车
transportNo String 航班号或车次
departureStation String 出发站/机场
arrivalStation String 到达站/机场
travelDate LocalDate 乘坐日期
remark String 备注

响应 Result<OrderTransportVO>

字段 类型 说明
transportId String 交通信息ID
orderId String 订单ID
legType String 行程段：OUTBOUND=去程接站, RETURN=回程送站
transportType String 交通类型：FLIGHT=航班, TRAIN=火车
transportNo String 航班号或车次
departureStation String 出发站/机场
arrivalStation String 到达站/机场
travelDate LocalDate 乘坐日期
remark String 备注
createdByType String 填写人类型：ADMIN/USER
createdAt LocalDateTime 创建时间
planDepartTime String 计划出发时间
planArriveTime String 计划到达时间
actualDepartTime String 实际/预计出发时间
actualArriveTime String 实际/预计到达时间
liveStatus String 状态（如：计划/起飞/到达/延误/晚点）
extraInfo Map<String, String> 航班额外信息：航站楼/登机口/出口等

📌 DELETE /admin/order/transport/{transportId} — 删除交通信息

参数

  • {transportId} (Long) — 路径参数：交通信息ID

响应 Result<Void>

📌 GET /admin/order/{orderId}/transports — 查询订单交通信息（含实时动态）

返回订单的去程/回程交通信息，自动从飞常准API查询实时航班/火车状态。

参数

  • {orderId} (Long) — 路径参数：订单ID

响应 Result<List<OrderTransportVO>>

字段 类型 说明
transportId String 交通信息ID
orderId String 订单ID
legType String 行程段：OUTBOUND=去程接站, RETURN=回程送站
transportType String 交通类型：FLIGHT=航班, TRAIN=火车
transportNo String 航班号或车次
departureStation String 出发站/机场
arrivalStation String 到达站/机场
travelDate LocalDate 乘坐日期
remark String 备注
createdByType String 填写人类型：ADMIN/USER
createdAt LocalDateTime 创建时间
planDepartTime String 计划出发时间
planArriveTime String 计划到达时间
actualDepartTime String 实际/预计出发时间
actualArriveTime String 实际/预计到达时间
liveStatus String 状态（如：计划/起飞/到达/延误/晚点）
extraInfo Map<String, String> 航班额外信息：航站楼/登机口/出口等

🆕 新增: InternalOrderTransport

📖 接口文档: http://192.168.100.236:8084/doc.html → 标签 「【内部接口】订单交通信息（Feign调用）」

📌 GET /internal/order/transport/{orderId} — 查询订单交通信息（含实时动态）

参数

  • {orderId} (Long) — 路径参数

响应 Result<List<OrderTransportVO>>

字段 类型 说明
transportId String 交通信息ID
orderId String 订单ID
legType String 行程段：OUTBOUND=去程接站, RETURN=回程送站
transportType String 交通类型：FLIGHT=航班, TRAIN=火车
transportNo String 航班号或车次
departureStation String 出发站/机场
arrivalStation String 到达站/机场
travelDate LocalDate 乘坐日期
remark String 备注
createdByType String 填写人类型：ADMIN/USER
createdAt LocalDateTime 创建时间
planDepartTime String 计划出发时间
planArriveTime String 计划到达时间
actualDepartTime String 实际/预计出发时间
actualArriveTime String 实际/预计到达时间
liveStatus String 状态（如：计划/起飞/到达/延误/晚点）
extraInfo Map<String, String> 航班额外信息：航站楼/登机口/出口等

📌 POST /internal/order/transport/{orderId} — 添加交通信息（小程序用户）

参数

  • {orderId} (Long) — 路径参数
  • userId (Long) — 查询参数

响应 Result<OrderTransportVO>

字段 类型 说明
transportId String 交通信息ID
orderId String 订单ID
legType String 行程段：OUTBOUND=去程接站, RETURN=回程送站
transportType String 交通类型：FLIGHT=航班, TRAIN=火车
transportNo String 航班号或车次
departureStation String 出发站/机场
arrivalStation String 到达站/机场
travelDate LocalDate 乘坐日期
remark String 备注
createdByType String 填写人类型：ADMIN/USER
createdAt LocalDateTime 创建时间
planDepartTime String 计划出发时间
planArriveTime String 计划到达时间
actualDepartTime String 实际/预计出发时间
actualArriveTime String 实际/预计到达时间
liveStatus String 状态（如：计划/起飞/到达/延误/晚点）
extraInfo Map<String, String> 航班额外信息：航站楼/登机口/出口等
📁 全部变更文件 (点击展开) 
A	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpOrderTransportController.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
A	hl-order-service/src/main/java/com/hulalv/order/controller/AdminOrderTransportController.java
A	hl-order-service/src/main/java/com/hulalv/order/controller/InternalOrderTransportController.java
A	hl-order-service/src/main/java/com/hulalv/order/dto/OrderTransportRequest.java
A	hl-order-service/src/main/java/com/hulalv/order/entity/OrderTransport.java
A	hl-order-service/src/main/java/com/hulalv/order/feign/TransportFeignClient.java
A	hl-order-service/src/main/java/com/hulalv/order/feign/TransportFeignFallbackFactory.java
A	hl-order-service/src/main/java/com/hulalv/order/mapper/OrderTransportMapper.java
A	hl-order-service/src/main/java/com/hulalv/order/service/OrderTransportService.java
A	hl-order-service/src/main/java/com/hulalv/order/vo/OrderTransportVO.java
A	hl-transport-service/src/main/java/com/hulalv/transport/controller/InternalTransportController.java
A	sql/order_transport.sql