hl-api-changelog/changelogs/2026-03/2026-03-20_1127_508b792_feat.md

接口变更记录 — 2026-03-20 11:27

提交 508b792 · 作者 wx · 时间 2026-03-20 11:27:32 +0800

feat: 小程序酒店详情返回房型列表 + 新增房型详情接口

变更总览

• 小程序聚合服务
  • MpHotel (+1)
• 资源服务
  • InternalMpHotel (+1)

---

小程序聚合服务

MpHotel

📖 接口文档: http://192.168.100.236:8086/doc.html → 标签 「C端 - 酒店接口」

🆕 GET /mp/hotel/room-type/{roomTypeId} — 房型详情

获取房型完整信息，包含封面、轮播图、视频等素材URL，以及床型、面积、设施等详细信息。

参数

• {roomTypeId} (Long) — 路径参数：房型ID

响应 Result<Map<String, Object>>

---

资源服务

InternalMpHotel

📖 接口文档: http://192.168.100.236:8082/doc.html → 标签 「【内部接口】小程序酒店（Feign调用）」

🆕 GET /internal/mp/hotel/room-type/{roomTypeId} — C端房型详情

【仅限内部Feign调用】供mp-service获取房型完整详情，包含封面、轮播图、视频等素材URL。

关联字典：

• room_category：房型分类
• bed_type：床型
• window_type：窗户类型
• bathroom_type：卫浴类型
• room_facility：房间设施

参数

• {roomTypeId} (Long) — 路径参数：房型ID

响应 Result<RoomTypeVO>

字段	类型	说明
roomTypeId	String	房型ID
hotelId	String	所属酒店ID
name	String	房型名称
roomCategory	String	房型分类
roomArea	BigDecimal	房间面积（平方米）
bedType	String	床型
bedCount	Integer	床位数量
bedSize	String	床尺寸
maxOccupancy	Integer	最多入住人数
floorInfo	String	楼层信息
windowType	String	窗型
bathroomType	String	卫浴类型
roomFacilities	String	房间设施（JSON）
basePrice	BigDecimal	基础成本价（元）
totalRooms	Integer	总房间数
description	String	房型描述
coverMaterialId	String	封面素材ID
coverUrl	String	封面图URL
bannerMaterialIds	List<String>	横幅素材ID列表
bannerUrls	List<String>	横幅图URL列表
videoMaterialId	String	视频素材ID
videoUrl	String	视频URL
sortOrder	Integer	排序权重
status	Integer	状态：0=禁用 1=启用
approvalNo	String	审批单号
pendingStatus	Integer	待审批目标状态
createdAt	LocalDateTime	创建时间
updatedAt	LocalDateTime	更新时间

---

📦 其他数据对象变更

以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应

资源服务

✏️ HotelVO

• 🆕 roomTypes (List<RoomTypeVO>) — 房型列表（C端详情返回，仅包含已启用房型）

📁 全部变更文件 (点击展开)

M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpHotelController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/feign/MpResourceFeignClient.java
M	hl-mp-service/src/main/java/com/hulalv/mp/feign/MpResourceFeignFallbackFactory.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/controller/InternalMpHotelController.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/vo/HotelVO.java
M	nacos-config/hl-contract-service-dev.yml