docs: 小程序端按天+档位查看酒店列表接口指南

changelogs/2026-04/2026-04-16_mp-hotel-list-by-day-tier.md

@@ -0,0 +1,110 @@
+# 小程序端 — 按天+档位查看酒店列表
+
+- **日期**: 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` 查看房型列表