diff --git a/changelogs/2026-04/2026-04-16_mp-hotel-list-by-day-tier.md b/changelogs/2026-04/2026-04-16_mp-hotel-list-by-day-tier.md new file mode 100644 index 0000000..3a489b9 --- /dev/null +++ b/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\ | 横幅图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\ | 标签列表 | +| `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` 查看房型列表