91 行
2.1 KiB
Markdown
91 行
2.1 KiB
Markdown
# 配房可选酒店接口增加 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参数） |
|
||
|
||
#### 响应格式
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": [
|
||
{
|
||
"hotelId": "2033911514863382529",
|
||
"hotelName": "恩和瓦西里民宿",
|
||
"inSnapshot": true
|
||
},
|
||
{
|
||
"hotelId": "2033911514863382530",
|
||
"hotelName": "额尔古纳大酒店",
|
||
"inSnapshot": false
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
#### 响应字段说明
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| hotelId | String | 酒店ID |
|
||
| hotelName | String | 酒店名称 |
|
||
| inSnapshot | Boolean | 是否在该天产品快照中（true=该天行程已安排的酒店，应优先选择） |
|
||
|
||
- `inSnapshot=true` 的酒店排在前面
|
||
- 同时返回所有启用酒店供选择
|
||
|
||
---
|
||
|
||
## 前端改动要点
|
||
|
||
配房弹窗中选择酒店时，调用此接口需传当前正在配的那一天的 `dayIndex`：
|
||
|
||
```js
|
||
// 示例：配第2天的房间
|
||
const res = await request.get(`/admin/order/${orderId}/available-hotels`, {
|
||
params: { dayIndex: 2 }
|
||
})
|
||
```
|
||
|
||
**注意**：`dayIndex` 从 **1** 开始，对应行程的第1天、第2天...
|
||
|
||
---
|
||
|
||
## 同步修复：产品保存报错
|
||
|
||
`refundPolicyIds` 字段兼容前端传空数组 `[]` 的情况（之前只接受对象 `{}`，传 `[]` 会返回400）。现在传 `[]` 等价于 `null`，不影响保存。
|