# 小程序端 — 按天+档位查看酒店列表

- **日期**: 2026-04-16
- **服务**: hl-product-service-v2
- **类型**: 使用指南

## 接口

```
GET /mp/product/{id}/day/{dayNumber}/hotels
```

**无需登录**，已加入网关白名单。

## 参数

| 参数 | 位置 | 类型 | 必填 | 说明 |
|------|------|------|------|------|
| id | path | Long | 是 | 产品ID |
| dayNumber | path | Integer | 是 | 天序号（从1开始） |

## 响应示例

```json
{
  "code": 200,
  "data": {
    "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", "https://oss.xxx/2.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": [
          {
            "hotelId": 2023714929877450800,
            "name": "呼伦贝尔香格里拉大酒店",
            "coverUrl": "https://oss.xxx/cover2.jpg",
            "roomTypeName": "行政套房",
            "roomCount": 2
          }
        ]
      }
    ]
  }
}
```

## 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| `tiers` | List | 按档位分组的酒店列表 |
| `tiers[].tierSeq` | Integer | 档位序号（1=舒适，2=高档等） |
| `tiers[].tierName` | String | 档位名称 |
| `tiers[].hotels` | List | 该档位下的酒店列表 |
| `hotels[].hotelId` | Long | 酒店ID |
| `hotels[].name` | String | 酒店名称 |
| `hotels[].hotelType` | String | 住宿类型（字典hotel_type: HOTEL/HOMESTAY/RESORT/CAMPSITE） |
| `hotels[].starLevel` | String | 星级（字典hotel_star: THREE/FOUR/FIVE/BOUTIQUE） |
| `hotels[].coverUrl` | String | 封面图URL |
| `hotels[].bannerUrls` | List\<String\> | 横幅图URL列表 |
| `hotels[].address` | String | 详细地址 |
| `hotels[].longitude` | BigDecimal | 经度 |
| `hotels[].latitude` | BigDecimal | 纬度 |
| `hotels[].facilities` | String | 设施配置（JSON） |
| `hotels[].highlights` | String | 酒店亮点（JSON） |
| `hotels[].description` | String | 酒店描述 |
| `hotels[].checkInTime` | String | 入住时间 |
| `hotels[].checkOutTime` | String | 退房时间 |
| `hotels[].tags` | List\<String\> | 标签列表 |
| `hotels[].roomTypeId` | Long | 绑定的房型ID |
| `hotels[].roomTypeName` | String | 绑定的房型名称 |
| `hotels[].roomCount` | Integer | 房间数 |

## 前端使用场景

1. **每日行程页 → 点击"住宿"区块** → 调此接口获取当天酒店详情
2. 单档位产品：`tiers` 只有1个元素，直接展示 `hotels`
3. 多档位产品：用 tab 切换档位，按 `tierSeq` 展示对应 `hotels`
4. 点击某个酒店 → 可继续调 `GET /mp/product/hotel/{hotelId}/room-types` 查看房型列表