2.8 KiB
2.8 KiB
接口变更记录 — 2026-03-21 09:09
提交
573e671· 作者 wx · 时间 2026-03-21 09:09:39 +0800fix: 新增管理端获取订单出行人接口 GET /admin/order/{orderId}/travelers
变更总览
- 订单服务
- AdminOrder (+4)
订单服务
AdminOrder
📖 接口文档: http://192.168.100.236:8084/doc.html → 分组 「3.1 订单管理」 → 标签 「管理端订单接口」
🆕 GET /admin/order/{orderId}/travelers — 获取订单出行人列表
返回指定订单的所有出行人信息，用于保险投保时自动填充被保人。
参数
{orderId}(Long) — 路径参数：订单ID
响应 Result<List<OrderTraveler>>
| 字段 | 类型 | 说明 |
|---|---|---|
orderTravelerId |
Long |
出行人记录ID |
orderId |
Long |
订单ID |
name |
String |
出行人姓名 |
idCardType |
String |
证件类型（字典：id_card_type） |
idCardNo |
String |
证件号码（加密存储） |
phone |
String |
手机号码（加密存储） |
gender |
Integer |
性别（字典：gender） |
birthday |
LocalDate |
出生日期 |
travelerType |
String |
出行人类型（字典：traveler_type） |
nationality |
String |
国籍 |
emergencyContact |
String |
紧急联系人姓名 |
emergencyPhone |
String |
紧急联系人电话（加密存储） |
email |
String |
邮箱地址 |
deletedAt |
LocalDateTime |
删除时间（软删除） |
createTime |
LocalDateTime |
创建时间 |
updateTime |
LocalDateTime |
更新时间 |
🆕 POST /admin/order/{orderId}/surcharge — 添加费用增加项
为订单添加费用增加项（如升级房型补差价、加座费等）。
参数
{orderId}(Long) — 路径参数：订单ID
请求体 SurchargeRequest
响应 Result<OrderSurcharge>
🆕 PUT /admin/order/{orderId}/surcharge/{surchargeId} — 修改费用增加项
修改已添加的费用增加项名称或金额，修改后自动重算订单尾款金额。
参数
{orderId}(Long) — 路径参数：订单ID{surchargeId}(Long) — 路径参数：费用增加项ID
请求体 SurchargeRequest
响应 Result<Void>
🆕 DELETE /admin/order/{orderId}/surcharge/{surchargeId} — 删除费用增加项
删除已添加的费用增加项，删除后自动重算订单尾款金额。
参数
{orderId}(Long) — 路径参数：订单ID{surchargeId}(Long) — 路径参数：费用增加项ID
响应 Result<Void>
📁 全部变更文件 (点击展开)
M hl-order-service/src/main/java/com/hulalv/order/controller/AdminOrderController.java