POST/hotel/queryHotelRoomTypeTreePage管理后台

房型表-分页查询(树形)

酒店 / 房型· HotelRoomTypeController#queryHotelRoomTypeTreePage

基本信息

  • 接口状态前端在用 置信度 高
  • 接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/hotel/queryHotelRoomTypeTreePage
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道管理后台　前缀 /manage-api
  • 名称来源源码注释
  • 调用方已确认在用 · 管理后台（1 个前端）
  • 需求上下文酒店 房型
  • 维护人 / 最后改动hao　2024-12-12　最近提交：酒店 房型
  • 读写数据表hotel_room_type、hotel_room_type_plan、hotel_room_attr_rel、hotel_room_attr　反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.hotel.HotelRoomTypeController#queryHotelRoomTypeTreePage
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/hotel/HotelRoomTypeController.java:91
  • 判定依据1 个调用点：dscp-html-manage/src/api/hotel/hotel.ts

请求参数

分页字段来自 AbstractPageRequest：pageNo（不是 pageNum）· pageSize · orderBy

Header 请求参数

参数名参数值是否必填参数类型描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名参数值是否必填参数类型描述说明
无

路径参数及说明

参数名参数值是否必填参数类型描述说明
无

Body 请求参数

Body 类型 HotelRoomTypePageRequest
参数名参数值是否必填参数类型描述说明
pageNo…否Integer当前页面
pageSize…否Integer每页记录数
orderBy…否String排序语句
merchantId…否Long所属商户id，关联merchant表id → hotel_room_type.merchant_id
shopId…否Long所属商铺id，关联shop表id → hotel_room_type.shop_id
hotelId…否Long所属酒店ID → hotel_room_type.hotel_id
name…否String房型名称 → hotel_room_type.name
status…否Integer → hotel_room_type.status
keywords…否String关键字

认证方式

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

响应参数

data 类型 PageInfo<HotelRoomTypeTreeResponse>
参数名参数值是否必填参数类型描述说明
list…否List<T><HotelRoomTypeTreeResponse>分页数据集合（元素结构见下一行）
id…否Longid → hotel_room_type.id
hotelId…否Long酒店ID → hotel_room_type.hotel_id
name…否String房型名称 → hotel_room_type.name
basePrice…否Integer基础价格(分) → hotel_room_type.base_price
sort…否Integer排序号 → hotel_room_type.sort
status…否Integer状态(0正常 1停用) → hotel_room_type.status
coverImage…否String主图URL → hotel_room_type.cover_image
images…否String房型图片，多个用逗号分隔 → hotel_room_type.images
roomTypeArea…否BigDecimal面积(平方米) → hotel_room_type.room_type_area
floorInfo…否String楼层信息 → hotel_room_type.floor_info
windowType…否WindowType窗户类型 → hotel_room_type.window_type 1＝无窗 2＝部分有窗 3＝全部有窗
bedInfo…否String床型 → hotel_room_type.bed_info
guests…否Integer可住人数 → hotel_room_type.guests
smoking…否Integer是否禁烟(0否 1是) → hotel_room_type.smoking
networkType…否NetworkType网络类型 → hotel_room_type.network_type 1＝免费WiFi 2＝收费WiFi 3＝无网络
extraBedAllowed…否Integer是否可加床(0否 1是) → hotel_room_type.extra_bed_allowed
extraBedDesc…否String加床说明 → hotel_room_type.extra_bed_desc
facilities…否List<FacilityTree>设施列表
showPrice…否Integer
pricePlans…否List<HotelRoomTypePlan>价格方案列表
id…否Longid → hotel_room_type.id
hotelId…否Long酒店ID → hotel_room_type.hotel_id
roomTypeId…否Long房型ID → hotel_room_attr_rel.room_type_id
name…否String方案名称 → hotel_room_type.name
autoConfirm…否Integer是否自动确认 → hotel_room_type_plan.auto_confirm
breakfast…否Integer是否含早 → hotel_room_type_plan.breakfast
basePrice…否Integer底价(分) → hotel_room_type.base_price
salePrice…否Integer卖价(分) → hotel_room_type_plan.sale_price
stockType…否StockType库存类型 → hotel_room_type_plan.stock_type 0＝无限 1＝共享 2＝独立
stockNum…否Integer数量 → hotel_room_type_plan.stock_num
cancelType…否CancelType取消类型 → hotel_room_type_plan.cancel_type 1＝免费取消 2＝不可取消 3＝有条件取消
cancelDays…否Integer提前取消天数，0表示入住当天 → hotel_room_type_plan.cancel_days
cancelHours…否String取消截止时间点，如18:00 → hotel_room_type_plan.cancel_hours
sort…否Integer排序号 → hotel_room_type.sort
status…否Integer状态 → hotel_room_type.status
isDeleted…否Boolean是否删除(0否 1是) → hotel_room_type.is_deleted
createdBy…否Long创建人ID → hotel_room_type.created_by
createdTime…否Date创建时间 → hotel_room_type.created_time
updatedBy…否Long更新人ID → hotel_room_type.updated_by
updatedTime…否Date更新时间 → hotel_room_type.updated_time
id…否Longid → hotel_room_type.id
name…否String名称 → hotel_room_type.name
type…否HotelTemplateType类型 → hotel_room_attr.type 1＝酒店设施 2＝酒店政策 3＝其他 4＝房型设施 5＝房型政策
level…否Integer层级 → hotel_room_attr.level
sort…否Integer排��� → hotel_room_type.sort
children…否List<FacilityTree>子节点
total…否Long数据总数

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "list": "[]",
    "id": "1",
    "hotelId": "1",
    "name": "\"string\"",
    "basePrice": "1",
    "sort": "1",
    "status": "1",
    "coverImage": "\"string\"",
    "images": "\"string\"",
    "roomTypeArea": "1.0",
    "floorInfo": "\"string\"",
    "windowType": "1"
  }
}
示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：hotel_room_type、hotel_room_type_plan、hotel_room_attr_rel、hotel_room_attr　反查全部引用接口 →
  • HotelRoomTypeController#queryHotelRoomTypeTreePage
  • HotelRoomTypeService#queryPage（HotelRoomTypeServiceImpl）
  • HotelRoomTypeMapper#queryPage
  • HotelRoomTypePlanService#queryList（HotelRoomTypePlanServiceImpl）
  • HotelRoomTypePlanMapper#queryList
  • HotelRoomAttrRelService#queryList（HotelRoomAttrRelServiceImpl）
  • HotelRoomAttrRelMapper#queryList
  • HotelRoomAttrService#queryList（HotelRoomAttrServiceImpl）
  • HotelRoomAttrMapper#queryList
  • BeanUtils.map → HotelRoomTypeQuery
  • BeanUtils.map → HotelRoomTypeTreeResponse
逻辑摘要：分页查询（hotelRoomTypeService.queryPage）；列表查询（hotelRoomTypePlanService.queryList）；列表查询（hotelRoomAttrRelService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射
源码内联注释（旧站解析结果）
  • 1. 查询房型基本信息
  • 2. 转换并填充设施信息
  • 查询价格方案
  • 查询房型关联的设施
  • 查询设施详情
  • 构建设施树
  • 3. 构建返回结果
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
  • dscp-html-manage/src/api/hotel/hotel.ts:68　管理后台 · request
← 房型表-列表查询房型表-状态 →
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写，均来自同一份数据