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

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

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

接口

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

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

参数

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

响应示例

{
  "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 查看房型列表