189 行
4.6 KiB
Markdown
189 行
4.6 KiB
Markdown
# 小程序端酒店详情3个接口 + HotelInfo补tierName + 退款政策
|
||
|
||
- **日期**: 2026-04-16
|
||
- **服务**: hl-product-service-v2, hl-gateway
|
||
- **PR**: #684
|
||
- **类型**: feat
|
||
|
||
## 一、每日住宿补充 tierName
|
||
|
||
`GET /mp/product/{id}` 和 `GET /mp/product/{id}/day/{dayNumber}` 的 `hotels[]` 新增字段：
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `tierName` | String | 档位名称（如"舒适"、"高档"） |
|
||
|
||
前端可直接用 `tierName` 显示档位标签，不再需要从 `tiers` 中按 `tierSeq` 匹配。
|
||
|
||
---
|
||
|
||
## 二、3个新接口（酒店详情 / 房型列表 / 房型详情）
|
||
|
||
### 1. 产品某天住宿详情
|
||
|
||
```
|
||
GET /mp/product/{id}/day/{dayNumber}/hotels
|
||
```
|
||
|
||
**参数**: 产品ID + 天序号（1开始）
|
||
|
||
**响应**（按档位分组）:
|
||
|
||
```json
|
||
{
|
||
"dayNumber": 1,
|
||
"tiers": [
|
||
{
|
||
"tierSeq": 1,
|
||
"tierName": "舒适",
|
||
"hotels": [
|
||
{
|
||
"hotelId": 2023714929877450753,
|
||
"name": "呼伦贝尔香格里拉大酒店",
|
||
"hotelType": "HOTEL",
|
||
"starLevel": "FIVE",
|
||
"province": "内蒙古",
|
||
"city": "呼伦贝尔",
|
||
"district": "海拉尔区",
|
||
"address": "河东新区...",
|
||
"longitude": 119.736,
|
||
"latitude": 49.212,
|
||
"coverUrl": "https://oss.xxx/cover.jpg",
|
||
"bannerUrls": ["https://oss.xxx/1.jpg"],
|
||
"facilities": "{\"wifi\":true,\"parking\":true}",
|
||
"highlights": "{\"items\":[\"草原景观房\"]}",
|
||
"description": "五星级草原度假酒店...",
|
||
"checkInTime": "14:00",
|
||
"checkOutTime": "12:00",
|
||
"checkInNotes": "需携带身份证",
|
||
"tags": ["五星级", "草原景观"],
|
||
"roomTypeId": 3002000000000000013,
|
||
"roomTypeName": "豪华大床房",
|
||
"roomCount": 2
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"tierSeq": 2,
|
||
"tierName": "高档",
|
||
"hotels": [...]
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### 2. 酒店房型列表
|
||
|
||
```
|
||
GET /mp/product/hotel/{hotelId}/room-types
|
||
```
|
||
|
||
**参数**: 酒店ID
|
||
|
||
**响应**:
|
||
|
||
```json
|
||
{
|
||
"hotelId": 2023714929877450753,
|
||
"hotelName": "呼伦贝尔香格里拉大酒店",
|
||
"roomTypes": [
|
||
{
|
||
"roomTypeId": 3002000000000000013,
|
||
"name": "豪华大床房",
|
||
"roomCategory": "KING",
|
||
"bedType": "KING_BED",
|
||
"maxOccupancy": 2,
|
||
"coverUrl": "https://oss.xxx/room-cover.jpg"
|
||
},
|
||
{
|
||
"roomTypeId": 2023727403196502017,
|
||
"name": "标准双床房",
|
||
"roomCategory": "STANDARD",
|
||
"bedType": "TWIN_BED",
|
||
"maxOccupancy": 2,
|
||
"coverUrl": null
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### 3. 房型详情
|
||
|
||
```
|
||
GET /mp/product/room-type/{roomTypeId}
|
||
```
|
||
|
||
**参数**: 房型ID
|
||
|
||
**响应**:
|
||
|
||
```json
|
||
{
|
||
"roomTypeId": 3002000000000000013,
|
||
"hotelId": 2023714929877450753,
|
||
"name": "豪华大床房",
|
||
"roomCategory": "KING",
|
||
"roomArea": 35.0,
|
||
"bedType": "KING_BED",
|
||
"bedCount": 1,
|
||
"bedSize": "1.8m",
|
||
"maxOccupancy": 2,
|
||
"floorInfo": "8-15层",
|
||
"windowType": "FLOOR_WINDOW",
|
||
"bathroomType": "PRIVATE",
|
||
"roomFacilities": "{\"minibar\":true,\"bathtub\":true}",
|
||
"description": "草原景观豪华大床房...",
|
||
"coverUrl": "https://oss.xxx/room-cover.jpg",
|
||
"bannerUrls": ["https://oss.xxx/r1.jpg", "https://oss.xxx/r2.jpg"],
|
||
"videoUrl": null
|
||
}
|
||
```
|
||
|
||
### 接口说明
|
||
|
||
- 3个接口均**无需登录**（已加入网关JWT白名单）
|
||
- 接口1的酒店详情通过Feign调资源服务获取，未绑定资源时用快照名称兜底
|
||
- 接口2从酒店详情中提取房型列表（仅返回已启用房型）
|
||
|
||
---
|
||
|
||
## 三、退款政策字段
|
||
|
||
### 管理端 Step5 保存
|
||
|
||
`PUT /admin/product/item/{id}/supplement` 新增字段：
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `refundPolicyId` | Long | 退款政策ID（从 `GET /admin/order/refund-policy/enabled` 下拉框选择） |
|
||
|
||
根据产品支付类型选择对应退款政策（全款退款 / 定金退款）。
|
||
|
||
### 小程序端
|
||
|
||
`GET /mp/product/{id}` 新增字段：
|
||
|
||
```json
|
||
{
|
||
"refundPolicy": {
|
||
"policyName": "全款默认退款政策",
|
||
"rules": [
|
||
{ "minDays": 15, "refundRatio": 100 },
|
||
{ "minDays": 7, "refundRatio": 80 },
|
||
{ "minDays": 3, "refundRatio": 50 },
|
||
{ "minDays": 0, "refundRatio": 20 }
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `refundPolicy` | Object | 退款政策（未配置时为null） |
|
||
| `refundPolicy.policyName` | String | 政策名称 |
|
||
| `refundPolicy.rules` | List | 退款规则列表 |
|
||
| `refundPolicy.rules[].minDays` | Integer | 距出发最少天数 |
|
||
| `refundPolicy.rules[].refundRatio` | Integer | 退款比例（百分比0-100） |
|
||
|
||
含义：出发前≥15天退100%，≥7天退80%，≥3天退50%，<3天退20%。
|