API Changelog Bot 25290f9b81 feat: 配房可选酒店接口增加dayIndex参数 + 产品保存refundPolicyIds兼容数组

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-20 09:44:44 +08:00

2.1 KiB

原始文件 Blame 文件历史

配房可选酒店接口增加 dayIndex 参数

日期: 2026-03-20 类型: 接口变更（不兼容） 影响模块: 订单管理 → 配房

变更说明

GET /admin/order/{orderId}/available-hotels 接口新增必填参数 dayIndex，因为每天行程的酒店可能不同，配房需要按天查询可选酒店。

变更前

GET /admin/order/{orderId}/available-hotels

返回所有天的快照酒店，不区分行程天。

变更后

GET /admin/order/{orderId}/available-hotels?dayIndex=2

只返回指定行程天的快照酒店标注。

接口定义

`GET /admin/order/{orderId}/available-hotels`

请求参数

参数	类型	必填	说明
orderId	Long	是	订单ID（路径参数）
dayIndex	Integer	是	行程第几天（从1开始，Query参数）

响应格式

{
  "code": 200,
  "data": [
    {
      "hotelId": "2033911514863382529",
      "hotelName": "恩和瓦西里民宿",
      "inSnapshot": true
    },
    {
      "hotelId": "2033911514863382530",
      "hotelName": "额尔古纳大酒店",
      "inSnapshot": false
    }
  ]
}

响应字段说明

字段	类型	说明
hotelId	String	酒店ID
hotelName	String	酒店名称
inSnapshot	Boolean	是否在该天产品快照中（true=该天行程已安排的酒店，应优先选择）

inSnapshot=true 的酒店排在前面
同时返回所有启用酒店供选择

前端改动要点

配房弹窗中选择酒店时，调用此接口需传当前正在配的那一天的 dayIndex：

// 示例：配第2天的房间
const res = await request.get(`/admin/order/${orderId}/available-hotels`, {
  params: { dayIndex: 2 }
})

注意：dayIndex 从 1 开始，对应行程的第1天、第2天...

同步修复：产品保存报错

refundPolicyIds 字段兼容前端传空数组 [] 的情况（之前只接受对象 {}，传 [] 会返回400）。现在传 [] 等价于 null，不影响保存。

2.1 KiB 原始文件 Blame 文件历史 Unescape Escape